home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / sb_117_2.zip / SDOC117B.ASC < prev    next >
Text File  |  1993-01-29  |  292KB  |  7,251 lines

  1.         Chapter 5.     Menus
  2.         ==============================================================
  3.  
  4.         5.1       General information
  5.         --------------------------------------------------------------
  6.  
  7.         Just like QuickBBS and RemoteAccess is SuperBBS using a menu
  8.         system that requires to be build up from scratch. (Although an
  9.         easy installation program with some simple menus is included.)
  10.         You will have to setup all menus and external screens. Super-
  11.         BBS does include it's own menu program, which has all options
  12.         available. It also supports 'unknown' menu options, so you can
  13.         always use it. At this moment it is the only menu editor which
  14.         supports the multi language options in SuperBBS. Any other
  15.         menu program for QuickBBS is usable, as long as it supports
  16.         'unlisted' menu types, since SuperBBS has more menu options
  17.         than QuickBBS has.
  18.  
  19.         There are several ways to setup a menu system for your BBS.
  20.         The most used one looks like this:
  21.  
  22.                        -------------------- Message menus
  23.                        |
  24.         Main menu ------------------------- File menus
  25.                        |
  26.                        -------------------- Other menus
  27.  
  28.         Another method is to set up your menus by item:
  29.  
  30.         Main menu ------------------------- SuperBBS file & message
  31.                        |
  32.                        |------------------- Modem file & message
  33.                        |
  34.                        -------------------- Graphics file & message
  35.  
  36.         Either way, plan your menu structure carefully. Users like a
  37.         menu structure which is easy to follow.
  38.  
  39.         Building a menu can be done in two ways. You can either build
  40.         the whole menu with the menu editor, so text is displayed if
  41.         needed, or you can start your menu with an ANSI/ASCII display
  42.         option (with Hot-key) which will display the menu and have all
  43.         the commands in the menu file. Both have advantages and disad-
  44.         vantages.
  45.  
  46.         Using an ANSI/ASCII file as menu gives you the advantages that
  47.         you can use more colours on one line, use graphics and even
  48.         animation. Disadvantage is that all menu options will be
  49.         visible to all callers, whatever securitylevel they have. You
  50.         need to setup a display file option with a Crtl-A code, which
  51.         means the command will be executed automatically.
  52.  
  53.  
  54.  
  55.  
  56.  
  57.         --------------------------------------------------------------
  58.         SuperBBS v1.17 Documentation                          Page 106
  59.  
  60.  
  61.         Using the normal menu has the advantages that you can hide
  62.         several options from other security levels. Disadvantage is
  63.         the limited use of colour per line. It will be up to you which
  64.         way you choose.
  65.  
  66.         Be sure to check your menu files at every securitylevel you
  67.         have set up. Strange things can happen if you make mistakes.
  68.         Building a menu is simple, building a complex menu with many
  69.         different options for different securitylevels is more diffi-
  70.         cult. Take your time is a good advice.
  71.  
  72.         When building a menu, you will need to enter the following
  73.         information:
  74.  
  75.         Text to display     Text shown to user for this menu option.
  76.                             (Leave this empty if you use an ANSI/ASCII
  77.                             file to display the menu.) This line
  78.                             should contain a description and the char-
  79.                             acter to activate it.
  80.  
  81.         Optional data       Optional data needed for the given menu
  82.                             type command. (See the menu commands.)
  83.  
  84.         Menu type           Number of the menu type. (These will be
  85.                             listed below with a full description and
  86.                             the optional data needed.)
  87.  
  88.         Security            Securitylevel needed to access this menu
  89.                             option.
  90.  
  91.         Key                 Key which activates this menu option. This
  92.                             can be any character on the keyboard.
  93.  
  94.         Foreground          Colour in which the foreground of the text
  95.                             to display will appear. (Options: 0-15)
  96.  
  97.         Background          Colour in which the background of the text
  98.                             to display will appear. (Options: 0-7)
  99.  
  100.         Flags A-D           Flagsettings needed to access this menu
  101.                             option.
  102.  
  103.         Two special options are:
  104.  
  105.         Highlight colour    The highlight colour is a colour
  106.                             which can be displayed on the text to
  107.                             display line through using a '^' in
  108.                             front and behind the text you want
  109.                             'highlighted'.
  110.  
  111.  
  112.  
  113.  
  114.  
  115.         --------------------------------------------------------------
  116.         SuperBBS v1.17 Documentation                          Page 107
  117.  
  118.  
  119.                             An example:
  120.  
  121.                                  Foreground colour:  2
  122.                                  Background colour:  0
  123.                                  Highlight colour...: 14
  124.  
  125.                             Text:   This is a ^test^ for a menu.
  126.                             Result: This is a test for a menu.
  127.  
  128.                             The word 'test' will appear in yellow, the
  129.                             rest of the line in dark green. Note that
  130.                             the special characters are not shown when
  131.                             displaying a menu.
  132.  
  133.         Prompt              Line displayed below the menu options,
  134.                             prompting the user for an action. This
  135.                             line can have a different colour.
  136.  
  137.         Note that the supplied SuperBBS menu editor works a bit diffe-
  138.         rent. But you still have to supply the above information. See
  139.         the external utilities part of the documentation for infor-
  140.         mation on the SuperBBS menu editor.
  141.  
  142.         These descriptions can differ from menu program to menu pro-
  143.         gram, but the main idea stays the same. Use a menu editor
  144.         which has an option for 'unknown' commands, since SuperBBS is
  145.         expanding faster than the menu editors are, so you will be
  146.         able to use the editor in the future.
  147.  
  148.         5.2       Menu commands
  149.         --------------------------------------------------------------
  150.  
  151.         Now for the available menu commands. SuperBBS is pretty power-
  152.         ful and has a lot of features, so read carefully. Make sure
  153.         you take note of any optional data needed to set up a menu
  154.         option. Without this data the menu option will not work or
  155.         behave strangely.
  156.  
  157.         Used characters in the optional data fields:
  158.  
  159.              None    = means no optional data needed
  160.              xxxxxxx = means the data entered here is mandatory.
  161.              <xxxxx> = means the data entered here is optional.
  162.  
  163.         The menu commands:
  164.  
  165.         Type.........: 0
  166.         Description..: Text line
  167.                        Display's the text you've entered in the menu
  168.                        editor for this command. No other action takes
  169.                        place.
  170.         Optional data: None
  171.  
  172.  
  173.         --------------------------------------------------------------
  174.         SuperBBS v1.17 Documentation                          Page 108
  175.  
  176.  
  177.      |  Type.........: 1
  178.      |  Description..: Goto a new menu.
  179.      |                 Will change the menu to the menu set up in the
  180.      |                 optional data field.
  181.      |  Optional data: MenuName </F></M></D></NS></T></A> <Password>
  182.      |                 If you want to protect your menu with a pass-
  183.      |                 word, enter it behind the menu name, separated
  184.      |                 with a space. Enter the menu name without the
  185.      |                 .MNU extension. See for /F, /D and /M the part
  186.      |                 in this documentation about 'menu templating'.
  187.      |                 The /NS option will not send a CLS code before
  188.      |                 displaying the menu. The /T option is used to
  189.      |                 set opening hours on the menu option. You will
  190.      |                 have to use it in this way: /T??:??-??:?? The
  191.      |                 first ??:?? is the start time, the second ??:??
  192.      |                 is the closing time of the menu option both in
  193.      |                 24 hour format. When the menu option is closed,
  194.      |                 a message will be displayed. The /A option is
  195.      |                 used to set a minimum age for the menu option.
  196.      |                 You will have to use it in this way: /A???,
  197.      |                 where ??? is the age. If the user is too young,
  198.      |                 a message is displayed. The password has to be
  199.      |                 the last option on the line.
  200.  
  201.      |  Type.........: 2
  202.      |  Description..: Gosub to a new menu.
  203.      |                 Same as option 1, with the difference that the
  204.      |                 previous menu (the menu you left from) will be
  205.      |                 added to the stack of menus you've visited.
  206.      |                 This way you can follow the trail back through
  207.      |                 your menus.
  208.      |  Optional data: MenuName </F></M></D></NS></T></A> <Password>
  209.      |                 The same as for menu type 1.
  210.  
  211.         Type.........: 3
  212.         Description..: Return from last gosub.
  213.                        Return to the menu you last visited. This
  214.                        option only works if you use the type 2 menu
  215.                        option to get to a menu.
  216.         Optional data: None or /NS
  217.                        You don't have to enter any menu name, since
  218.                        the stack contains the name of the menu visited
  219.                        last. This name is erased after the return, so
  220.                        you can use menu type 3 again to return to the
  221.                        before last used menu. The /NS option will not
  222.                        send a CLS code before entering the previous
  223.                        menu.
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.         --------------------------------------------------------------
  232.         SuperBBS v1.17 Documentation                          Page 109
  233.  
  234.  
  235.      |  Type.........: 4
  236.      |  Description..: Goto new menu and clear gosub stack
  237.      |                 Clears the gosub stack used with menu options 2
  238.      |                 and 3. Then goes to the given menu in the
  239.      |                 optional data field.
  240.      |  Optional data: MenuName </F></M></D></NS></T></A> <Password>
  241.      |                 The same as for menu type 1
  242.  
  243.         Type.........: 5
  244.         Description..: Display .ANS/.ASC file
  245.                        Display a textfile from the textfile directory
  246.                        setup in CONFIG.EXE and LCONFIG.EXE. SuperBBS
  247.                        first looks in the current language text direc-
  248.                        tory. If not found, SuperBBS will look in the
  249.                        directory specified in CONFIG.EXE. If a user
  250.                        has ANSI on, SuperBBS will first look for an
  251.                        ANS file, then for an ASC file. If the user has
  252.                        ANSI off, SuperBBS only looks for the ASC file.
  253.         Optional data: FileName
  254.                        The filename to be displayed, without exten-
  255.         sion.
  256.  
  257.         Type.........: 6
  258.         Description..: Selection menu
  259.                        Display a textfile which has up to 9 options
  260.                        available of other text files and display the
  261.                        Selection menu prompt, as set up in the
  262.                        CONFIG.EXE program. You will need to name all
  263.                        files the same, except for the last number.
  264.                        Suppose your main file is called BULLET.ANS
  265.                        then your other files will be called
  266.                        BULLET1.ANS to BULLET9.ANS. (If you have 9
  267.                        files.) The main file is shown to the user. The
  268.                        user selects from the list displayed in the
  269.                        main file, which file he/she wants to read. If
  270.                        the user selects 3, the file BULLET3.ANS (or
  271.                        ASC) will be displayed. If the user selects 5,
  272.                        the file BULLET5.ANS will be displayed. After
  273.                        viewing the file, the user will be shown the
  274.                        main file again.
  275.         Optional data: FileName
  276.                        This filename can be 7 characters or less.
  277.                        (Character 8 is reserved for the other textfile
  278.                        numbers.) The extension is always ANS or ASC
  279.                        and the files should be in your textfiles
  280.                        directory.
  281.  
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.         --------------------------------------------------------------
  290.         SuperBBS v1.17 Documentation                          Page 110
  291.  
  292.  
  293.         Type.........: 7
  294.         Description..: Shell to DOS and run program
  295.                        This option is used for starting other pro-
  296.                        grams, like doorgames and mailscanners, in
  297.                        SuperBBS. It shells to DOS and starts the pro-
  298.                        gram given in the optional data field. SuperBBS
  299.                        will return to the menu the exit started from.
  300.         Optional data: ProgramName <Parameters>
  301.                        This menu is one of the difficult menu options
  302.                        available, because of the large amount of para-
  303.                        meters. These are the parameters available:
  304.  
  305.                        *B   Caller's bps rate. This will be 0 if
  306.                             local, or 300 to 38400 if online.
  307.                        *C   Full path to your COMMAND.COM file as set
  308.                             in the environment variable COMSPEC. (Con-
  309.                             sult your DOS manual for more information
  310.                             about COMSPEC.) This parameter is needed
  311.                             if you want to start a batchfile from this
  312.                             type 7 menu command.
  313.                        *E   Read EXITINFO.BBS when returning to BBS.
  314.                             This can be handy if the program used with
  315.                             the type 7 exit, changes some of the
  316.                             user's data, like a timebank.
  317.                        *F   User's firstname.
  318.                        *G   Status of ANSI graphics. (0=Off, 1=On)
  319.                        *H   Leave the Fossil driver (X00 or
  320.                             compatible) hot when exiting from
  321.                             SuperBBS. Some programs require this.
  322.                             (Most don't.)
  323.                        *I   Path of current language file.
  324.                        *J   User's screenlength
  325.                        *L   User's lastname.
  326.                        *N   Gives current node number.
  327.                        *P   Gives current COM port number.
  328.                        *R   User's recordnumber in the user database.
  329.                        *S   Swap SuperBBS to EMS or disk. If you run a
  330.                             program which needs more memory than the
  331.                             normal amount available, specify the *S
  332.                             option, so SuperBBS will swap itself to
  333.                             EMS or, if EMS is not available, to disk.
  334.                        *T   Time left this call.
  335.                        *U   Path to current template file area. (See
  336.                             menu templating.)
  337.                        *X   Template filename. SuperBBS now can pro-
  338.                             duce any kind of (ASCII style) exit file,
  339.                             supporting doors not made for SuperBBS.
  340.                             Create a template file with the extension
  341.                             .SBE and set it up as the door might need
  342.                             it. You have all control codes available.
  343.  
  344.  
  345.  
  346.  
  347.         --------------------------------------------------------------
  348.         SuperBBS v1.17 Documentation                          Page 111
  349.  
  350.  
  351.                             When you use the *X option in a type 7
  352.                             exit, SuperBBS will replace the template
  353.                             given in the optional data field, like
  354.                             *XFilename.SBE, to create the exitfile
  355.                             Filename.EXT. Example:
  356.  
  357.                             Exit template file: (TEST.SBE)
  358.  
  359.                                  ^FA
  360.                                  ^FB
  361.                                  ^KO
  362.                                  ^KV
  363.  
  364.                             Would give you an exitfile looking like
  365.                             this: (TEST.EXT)
  366.  
  367.                                  Aki Antman
  368.                                  Helsinki, Finland
  369.                                  45
  370.                                  290
  371.  
  372.                             Being the full username, city, remaining
  373.                             time online and time of next event.
  374.  
  375.                        Mostly you just use the *C and *S parameters.
  376.                        With multi-node operations, you will need the
  377.                        *N and *P options. Normally the documentation
  378.                        from the program you wish to run will supply
  379.                        the needed information.
  380.  
  381.         Type.........: 8
  382.         Description..: Version and copyright notice
  383.                        This option will show the user the version-
  384.                        number, copyright message and if your program
  385.                        is registered, the registration name of the
  386.                        SuperBBS version you're using.
  387.         Optional data: None
  388.  
  389.         Type.........: 9
  390.         Description..: Logoff from the system
  391.                        This will disconnect the user from your system.
  392.                        Before disconnect, SuperBBS will show the user
  393.                        the GOODBYE.ANS (or ASC) file, if available.
  394.                        When using high speed modems, it might be
  395.                        needed to put a Ctrl-A at the end of the file,
  396.                        otherwise slow modems won't see much of the
  397.                        screen.
  398.         Optional data: None
  399.  
  400.  
  401.  
  402.  
  403.  
  404.  
  405.         --------------------------------------------------------------
  406.         SuperBBS v1.17 Documentation                          Page 112
  407.  
  408.  
  409.         Type.........: 10
  410.         Description..: Display System Usage graph
  411.                        Show the user the system usage graph. This
  412.                        gives you the percentage use per hour.
  413.         Optional data: None or /H
  414.                        If used with the /H option, SuperBBS will dis-
  415.                        play a horizontal graph, instead of the normal
  416.                        graph.
  417.  
  418.         Type.........: 11
  419.         Description..: Page the Sys(tem)Op(erator) for a chat
  420.                        See if the Sysop is available to talk to you.
  421.                        SuperBBS will ask the user for a reason for the
  422.                        chat. If the Sysop is not available, this rea-
  423.                        son will be stored in the SYSTEM.LOG file.
  424.         Optional data: Prompt </FORCED>
  425.                        Enter the string, which will be shown to users
  426.                        who try to yell you. The /FORCED option will
  427.                        even start the yell outside yelling hours.
  428.                        Useful if you want your co-sysop or special
  429.                        users to call you even outside chat hours.
  430.  
  431.         Type.........: 12
  432.         Description..: Execute questionnaire file
  433.                        Execute the given questionnaire, for example
  434.                        NEWUSER.Q-A. The answers will be written in the
  435.                        same file name as the questionnaire, but the
  436.                        extension will be changed to .ASW.
  437.         Optional data: FileName
  438.                        Extension of a questionnaire must be .Q-A or
  439.                        SuperBBS will not recognize the questionnaire.
  440.                        Answers will be written in the .ASW file.
  441.  
  442.         Type.........: 13
  443.         Description..: List/search user list
  444.                        Gives the option to search for a name in the
  445.                        userlist or display the whole list.
  446.         Optional data: None, /S or /L
  447.                        If you specify no optional data, the list will
  448.                        contain no security levels. With the /S the
  449.                        securitylevels will be shown to the user. The
  450.                        /L option only shows the users with the same or
  451.                        lower security level.
  452.  
  453.         Type.........: 14
  454.         Description..: Time statistics
  455.                        Shows the user how long he/she has been on-line
  456.                        and how much time is left. Also gives the cur-
  457.                        rent date and time.
  458.         Optional data: None
  459.  
  460.  
  461.  
  462.  
  463.         --------------------------------------------------------------
  464.         SuperBBS v1.17 Documentation                          Page 113
  465.  
  466.  
  467.         Type.........: 15
  468.         Description..: Exits to DOS with errorlevel
  469.                        Leaves SuperBBS and returns to the batchfile
  470.                        which you ran SuperBBS from. There you inter-
  471.                        cept the given errorlevel and start an external
  472.                        action. (For more information about error-
  473.                        levels, consult your DOS manual and see the
  474.                        batch examples in the appendixes of this man-
  475.                        ual.) If possible you should use a type 7 exit,
  476.                        instead of this type 15. Use the *S (and *E)
  477.                        when using a type 7.
  478.         Optional data: Errorlevel <MenuName>
  479.                        The errorlevel will start the action required
  480.                        from your batchfile. (Don't use errorlevel
  481.                        below 10.) The optional MenuName tells SuperBBS
  482.                        to which menu it should return after ending the
  483.                        type 15 exit. You should restart the SuperBBS
  484.                        program with the -R option. (See Command Line
  485.                        Parameters.)
  486.  
  487.         Type.........: 16
  488.         Description..: Change City & State
  489.                        Allows the user to change his/her City and
  490.                        State.
  491.         Optional data: None
  492.  
  493.         Type.........: 17
  494.         Description..: Change password
  495.                        Allows the user to change his/her Password.
  496.         Optional data: None
  497.  
  498.         Type.........: 18
  499.         Description..: Change screenlength
  500.                        Allows the user to change his/her screenlength.
  501.         Optional data: None
  502.  
  503.         Type.........: 19
  504.         Description..: Toggle screen clearing on/off
  505.                        Allows the user to toggle the sending of screen
  506.                        clear codes (CLS) on and off.
  507.         Optional data: None
  508.  
  509.         Type.........: 20
  510.         Description..: Toggle the 'More (Y/n)' prompt on/off
  511.                        Allows the user to toggle the more prompt on
  512.                        and off.
  513.         Optional data: None
  514.  
  515.         Type.........: 21
  516.         Description..: Toggle ANSI graphics on/off
  517.                        Allows the user to toggle the ANSI graphics on
  518.                        and off.
  519.         Optional data: None
  520.  
  521.         --------------------------------------------------------------
  522.         SuperBBS v1.17 Documentation                          Page 114
  523.  
  524.  
  525.         Type.........: 22
  526.         Description..: Scan for personal mail
  527.                        This option will scan the userbase and report
  528.                        any unread personal mail.
  529.         Optional data: None </A> </G>
  530.                        The /A option tells SuperBBS to scan for new
  531.                        normal messages and for new group messages,
  532.                        while the /G option tells SuperBBS to only scan
  533.                        for new group messages. (See the chapter on the
  534.                        messagebase for more information on the group
  535.                        messages.)
  536.  
  537.      |  Type.........: 23
  538.      |  Description..: Read messages
  539.      |                 Allows the user to read messages in the current
  540.      |                 message area. If a message is private, it will
  541.      |                 be skipped if it is not from you or to you.
  542.      |  Optional data: AreaNumber or /M </F></R></I></N></S></M></O>
  543.      |                 Area number of the message base the messages
  544.      |                 should be read from. If you use menu templa-
  545.      |                 ting, this can also be the templating command
  546.      |                 /M. See for details on the extra options the
  547.      |                 chapter on changing hardcoded menu options.
  548.      |                 (Chapter 5.4)
  549.  
  550.      |  Type.........: 24
  551.      |  Description..: Scan messages
  552.      |                 Gives a list of messages with the header infor-
  553.      |                 mation (who from, who to and subject) and gives
  554.      |                 you the option to mark messages for later read-
  555.      |                 ing.
  556.      |  Optional data: Areanumber or /M </F></R></I></N></S></M></O>
  557.      |                 Area number of the message base the messages
  558.      |                 should be scanned from. If you use menu templa-
  559.      |                 ting, this can also be the templating command
  560.      |                 /M. See for details on the extra options the
  561.      |                 chapter on changing hardcoded menu options.
  562.      |                 (Chapter 5.4)
  563.  
  564.      |  Type.........: 25
  565.      |  Description..: Quick scan messages
  566.      |                 Gives a list like display of all messages in
  567.      |                 the area with information about the sender,
  568.      |                 receiver and subject.
  569.      |  Optional data: AreaNumber or /M </F></R></I></N></S></M></O>
  570.      |                 Area number of the message base the messages
  571.      |                 should be scanned from. If you use menu templa-
  572.      |                 ting, this can also be the templating command
  573.      |                 /M. See for details on the extra options the
  574.      |                 chapter on changing hardcoded menu options.
  575.      |                 (Chapter 5.4)
  576.  
  577.  
  578.  
  579.         --------------------------------------------------------------
  580.         SuperBBS v1.17 Documentation                          Page 115
  581.  
  582.  
  583.         Type.........: 26
  584.         Description..: Delete messages
  585.                        Removes messages from the message base. This
  586.                        only works for messages from you or to you.
  587.                        (Unless you have Sysop access to this area.)
  588.         Optional data: AreaNumber or /M
  589.                        Area number of the message base the messages
  590.                        should be deleted from. If you use menu templa-
  591.                        ting, this can also be the templating command
  592.                        /M.
  593.  
  594.         Type.........: 27
  595.         Description..: Write a message
  596.                        Allows the user to write a message.
  597.         Optional data: <AreaNumber> </M> </L> </T=First_Lastname>
  598.                        Area number of the message base to write the
  599.                        message in or the menu templating command /M.
  600.                        If you leave this field blank, SuperBBS will
  601.                        use this menu option as an global write option
  602.                        and will ask the user in which area he/she
  603.                        wants to write the message. The /L will log the
  604.                        user off your system after saving the message
  605.                        (with displaying the file GOODBYE.A??). The
  606.                        /T=First_Lastname will send the message to the
  607.                        name given. Spaces should be set with the
  608.                        underscore character. The /L and /T option only
  609.                        works correct if you use an area number and NOT
  610.                        the /M command. You could use the /L and /T
  611.                        parameters for sending a message to the Sysop
  612.                        at logoff.
  613.  
  614.      |  Type.........: 28
  615.      |  Description..: Select combined message/QWK areas
  616.      |                 Area 0 is a special message area. You can't
  617.      |                 write a message in this area, but you can read
  618.      |                 messages from all areas connected in numerical
  619.      |                 order. This option allows the user to select
  620.      |                 the areas he/she wants to use in his/her com-
  621.      |                 bined board. You can select standard areas or
  622.      |                 exclude areas from the combined board in the
  623.      |                 CONFIG.EXE program, the Message base part.
  624.      |                 This option is also used to select areas for
  625.      |                 the QWK mailreader system. Only areas selected
  626.      |                 will be used in the QWK mail search.
  627.      |  Optional data: None
  628.  
  629.  
  630.  
  631.  
  632.  
  633.  
  634.  
  635.  
  636.  
  637.         --------------------------------------------------------------
  638.         SuperBBS v1.17 Documentation                          Page 116
  639.  
  640.  
  641.         Type.........: 29
  642.         Description..: Move a file
  643.                        Normally spoken an option only available to the
  644.                        Sysop. It will allow you to move a file from
  645.                        one area to another. It also moves the descrip-
  646.                        tion in the FILES.BBS file.
  647.         Optional data: FullPath or /F
  648.                        You need to give the full directory path from
  649.                        where the file will be moved or the /F if you
  650.                        use menu templating.
  651.  
  652.         Type.........: 30
  653.         Description..: MS-Dos directory
  654.                        Like a normal DIR command, will SuperBBS dis-
  655.                        play the given directory.
  656.         Optional data: FullPath or /F
  657.                        Give the full directory path or the /F.
  658.  
  659.      |  Type.........: 31
  660.      |  Description..: List FILES.BBS
  661.      |                 The normal way to show a user what's available
  662.      |                 in the given directory. It will show the
  663.      |                 filename, date, size and description. For CD-
  664.      |                 Rom users is an option build in to have the
  665.      |                 FILES.BBS file in a different location then the
  666.      |                 files itself are. See the CONFIG.EXE program,
  667.      |                 the File area editor.
  668.      |                 SuperBBS will ask the user for a file mask to
  669.      |                 display. There is also an option to only dis-
  670.      |                 play the newfiles. this is done by entering /N
  671.      |                 at the filemask question.
  672.      |  Optional data: FullPath or /F </N>
  673.      |                 Supply the directory or the /F command. CD-Rom
  674.      |                 users should use the /F command. The /N option
  675.      |                 will only display the new files in that direc-
  676.      |                 tory.
  677.  
  678.         Type.........: 32
  679.         Description..: Download a file
  680.                        This option will send a file from the BBS to
  681.                        the user.
  682.         Optional data: None <FullPath> </F> <PassWord>
  683.                        If you leave the optional data field empty,
  684.                        SuperBBS will use this command as a global
  685.                        download command. It will search in every area
  686.                        the user has access to, trying to find the
  687.                        requested file. Use the full path or the /F
  688.                        option and SuperBBS will only look in the cur-
  689.                        rent area. The FullPath and /F option allow the
  690.                        use of a password, which need to be given
  691.                        before the download will be started.
  692.  
  693.  
  694.  
  695.         --------------------------------------------------------------
  696.         SuperBBS v1.17 Documentation                          Page 117
  697.  
  698.  
  699.                        Please note that the <*> option is no longer
  700.                        supported. This is replaced with an option in
  701.                        the FILES.CTL file. Please delete the * from
  702.                        your optional data fields, otherwise SuperBBS
  703.                        will ask for a password before downloading.
  704.  
  705.         Type.........: 33
  706.         Description..: Upload a file
  707.                        This option will receive a file which the user
  708.                        sends to the BBS.
  709.         Optional data: FullPath or /F
  710.                        Supply the full directory or the /F option. By
  711.                        using the full directory command, it is poss-
  712.                        ible to receive all uploads in one directory.
  713.                        The /F will place the file in the current area.
  714.  
  715.         Type.........: 34
  716.         Description..: View an archived file
  717.                        Shows what the archive file contains. It sup-
  718.                        ports ZIP, LZH, ARJ, PAK and ARC files.
  719.         Optional data: FullPath or /F
  720.                        Supply the full directory path or the /F
  721.                        option.
  722.  
  723.         Type.........: 35
  724.         Description..: Search for file by Keyword
  725.                        Look for a word in the FILES.BBS files.
  726.         Optional data: None
  727.  
  728.         Type.........: 36
  729.         Description..: Search for file by Filename
  730.                        Look for a file in the FILES.BBS files. Wild-
  731.                        cards are allowed as search options.
  732.         Optional data: None
  733.  
  734.         Type.........: 37
  735.         Description..: List new files on system
  736.                        Shows the new files since the last login or the
  737.                        given date. It is also possible to use the new
  738.                        files check since last time viewed. This means
  739.                        that SuperBBS will remember when the user last
  740.                        viewed the new files and will set the date to
  741.                        scan from to that specific date. This option
  742.                        can be configured in the main configuration
  743.                        program. When enabled, this option also works
  744.                        on the new files scan at logon.
  745.         Optional data: None
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.         --------------------------------------------------------------
  754.         SuperBBS v1.17 Documentation                          Page 118
  755.  
  756.  
  757.         Type.........: 38
  758.         Description..: Type a textfile
  759.                        Allows the users to read a textfile on-line
  760.                        from your FILES.BBS list. (If there is a text-
  761.                        file in there.)
  762.         Optional data: FullPath or /F
  763.                        Supply full directory path or the /F option.
  764.  
  765.         Type.........: 39
  766.         Description..: Display a textfile
  767.                        Show the user a textfile. This option is like
  768.                        menu option 5, except you have to supply the
  769.                        fullpath and filename. This allows you to show
  770.                        any file you want. No 'Press Return' is given
  771.                        at the end of the file.
  772.         Optional data: Fullpath and FileName
  773.                        Supply the full path and filename to the text-
  774.                        file. Including the extension!
  775.  
  776.         Type.........: 40
  777.         Description..: Display ANS/ASC file with Hotkey
  778.                        Show the user an ANSI or ASCI file, but keep
  779.                        the hot keys active. This can be used to dis-
  780.                        play a menu file. If you use this command to
  781.                        show the file, the user doesn't have to wait
  782.                        till the whole screen is drawn, but can make
  783.                        his choice at once. With a type 5 menu, the hot
  784.                        keys are not active during the display of the
  785.                        file. This command is mostly used in combina-
  786.                        tion with a Crtl-A command in your menu. (Crtl-
  787.                        A = Automatic execution)
  788.         Optional data: FileName
  789.                        Supply the filename to be shown. Don't give an
  790.                        extension, as SuperBBS will always look for a
  791.                        ANS or ASC extension. The file has to be in the
  792.                        textfile directory.
  793.  
  794.         Type.........: 41
  795.         Description..: Toggle Full Screen editor on/off
  796.                        If you have a full screen editor installed,
  797.                        like Quicked, you can allow your users to
  798.                        toggle the editor on and off with this option.
  799.                        If it is off, the build in editor will be used.
  800.         Optional data: None
  801.  
  802.         Type.........: 42
  803.         Description..: RESERVED - Do not use
  804.  
  805.         Type.........: 43
  806.         Description..: RESERVED - Do not use
  807.  
  808.         Type.........: 44
  809.         Description..: RESERVED - Do not use
  810.  
  811.         --------------------------------------------------------------
  812.         SuperBBS v1.17 Documentation                          Page 119
  813.  
  814.  
  815.         Type.........: 45
  816.         Description..: Display ANS/ASC file with 'Press ENTER'
  817.                        The same as menu type 5, except that SuperBBS
  818.                        will put a 'Press ENTER to continue' prompt
  819.                        after it showed the file. This will pause the
  820.                        screen till a reaction from the user is
  821.                        received.
  822.         Optional data: FileName or fullpath and filename
  823.                        Supply the filename, without extension. The
  824.                        file has to be in the textfile directory. If
  825.                        you supply the filename and path, you can dis-
  826.                        play any file and have the 'Press Enter' at the
  827.                        end.
  828.  
  829.         Type.........: 46
  830.         Description..: Show GIF pictures resolution
  831.                        Show the resolution of the GIF picture (only of
  832.                        if it is stored on you disk as a .GIF file),
  833.                        which name is supplied by the user. This option
  834.                        doesn't look in archives!
  835.         Optional data: FullPath or /F
  836.                        Supply the full directory path or use the /F
  837.                        option.
  838.  
  839.         Type.........: 47
  840.         Description..: Write entry to System log
  841.                        Write the text, given in the optional data
  842.                        field, to the SYSTEM.LOG file. This is handy if
  843.                        you want to know if a menu option is used or
  844.                        for any other information.
  845.         Optional data: Text to be written
  846.                        The text given in this field will be written to
  847.                        the system logfile.
  848.  
  849.         Type.........: 48
  850.         Description..: Download a specific file
  851.                        By using this option, you only ask the user
  852.                        which download protocol he/she wants to use and
  853.                        then starts the download. You supplied the
  854.                        filename in the optional data field. This can
  855.                        be used to download your ALLFILES list.
  856.         Optional data: FullPath+FileName
  857.                        Supply the file the users can download through
  858.                        the use of this option.
  859.  
  860.         Type.........: 49
  861.         Description..: RESERVED - Do not use
  862.  
  863.         Type.........: 50
  864.         Description..: RESERVED - Do not use
  865.  
  866.         Type.........: 51
  867.         Description..: RESERVED - Do not use
  868.  
  869.         --------------------------------------------------------------
  870.         SuperBBS v1.17 Documentation                          Page 120
  871.  
  872.  
  873.         Type.........: 52
  874.         Description..: RESERVED - Do not use
  875.  
  876.         Type.........: 53
  877.         Description..: Toggle mailcheck at logon on/off
  878.                        Allows the user to toggle the mailcheck at
  879.                        logon on and off.
  880.         Optional data: None
  881.  
  882.         Type.........: 54
  883.         Description..: Toggle newfiles check at logon on/off
  884.                        Allows the user to toggle the newfiles check at
  885.                        logon on or off.
  886.         Optional data: None
  887.  
  888.         Type.........: 55
  889.         Description..: Show BBS list (Short)
  890.                        Shows the user the build in BBS list in the
  891.                        short version.
  892.         Optional data: None
  893.  
  894.         Type.........: 56
  895.         Description..: Add BBS to BBS list
  896.                        Allows Sysops to add their BBS to your BBS
  897.                        list. Information like telephone number, name,
  898.                        on-line hours, software and Sysop name are
  899.                        stored.
  900.         Optional data: None
  901.  
  902.         Type.........: 57
  903.         Description..: Leave comment to next user
  904.                        A comment of 2 lines can be left behind for the
  905.                        next user. This will be shown to the next
  906.                        caller at logon. The user will not be logged
  907.                        off after entering the comment.
  908.         Optional data: None
  909.  
  910.         Type.........: 58
  911.         Description..: Show callers
  912.                        Gives a list of the last 15 callers with the
  913.                        time they came on-line and went off-line. Also
  914.                        shown are bps rates and age.
  915.         Optional data: None or /T
  916.                        If no optional data is specified the list will
  917.                        display the last 15 callers of all available
  918.                        lines. With the /T option, the list will con-
  919.                        tain all callers since midnight.
  920.  
  921.                        Please note that the filename for this option
  922.                        has changed in v1.16. The file used is now
  923.                        called SCALLERS.BBS and the old file
  924.                        SLCALLER.BBS is no longer used and can be
  925.                        deleted.
  926.  
  927.         --------------------------------------------------------------
  928.         SuperBBS v1.17 Documentation                          Page 121
  929.  
  930.  
  931.         Type.........: 59
  932.         Description..: Change colour configuration
  933.                        Allows the user to change the colour configur-
  934.                        ation of the BBS. This is the same as in the
  935.                        CONFIG.EXE program, but only works for the
  936.                        current user, while the CONFIG.EXE part, works
  937.                        for every user.
  938.         Optional data: None
  939.  
  940.         Type.........: 60
  941.         Description..: Extract files
  942.                        Allows the user to extract a file, then after-
  943.                        wards he/she can view the files inside the
  944.                        archive and repack (some) files. All from with-
  945.                        in SuperBBS.
  946.         Optional data: None <FullPath> </F>
  947.                        If you leave the optional data line empty, it
  948.                        means extract the file which is IN the TEMP
  949.                        directory. This TEMP directory is setup in the
  950.                        CONFIG.EXE program. If you enter the full
  951.                        directory path or the /F, for menu templating,
  952.                        this menu type will react as extract TO the
  953.                        TEMP directory. Note the difference!
  954.  
  955.         Type.........: 61
  956.         Description..: Archive files
  957.                        The user will be asked which files have to be
  958.                        archived. This option is to be used with the
  959.                        extract option, menu type 60.
  960.         Optional data: FullPath or /F
  961.                        If you enter the full directory path of the
  962.                        TEMP dir, the files will be packed from that
  963.                        area. If you use the /F or the full directory
  964.                        path to your file areas, the requested files
  965.                        from that area will be packed.
  966.  
  967.         Type.........: 62
  968.         Description..: Delete files
  969.                        The user will be asked which files have to be
  970.                        deleted. This option is to be used with the
  971.                        extract option, menu type 60.
  972.         Optional data: FullPath or /F
  973.                        If you enter the full directory path of the
  974.                        TEMP dir, the files will be deleted from that
  975.                        area. If you use the /F or the full directory
  976.                        path to your file areas, the requested files
  977.                        from that area will be deleted.
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.         --------------------------------------------------------------
  986.         SuperBBS v1.17 Documentation                          Page 122
  987.  
  988.  
  989.         Type.........: 63
  990.         Description..: Show BBS list (Long)
  991.                        Show the user the long version of the BBS list.
  992.                        The user has the option to enter the name
  993.                        he/she wants to look for. All available data
  994.                        about the BBS will be shown.
  995.         Optional data: None
  996.  
  997.         Type.........: 64
  998.         Description..: Change BBS information in BBS list
  999.                        Allows Sysops to change their BBS data in the
  1000.                        BBS list. Only you and the person named as
  1001.                        Sysop in the BBS list is able to do this.
  1002.         Optional data: None
  1003.  
  1004.         Type.........: 65
  1005.         Description..: Delete BBS information from BBS list
  1006.                        Allows Sysop to remove their data from the BBS
  1007.                        list. Only you and the person named as Sysop in
  1008.                        the BBS list is able to do this.
  1009.         Optional data: None
  1010.  
  1011.         Type.........: 66
  1012.         Description..: Download BBS list
  1013.                        Allows users to download the BBS list. Only the
  1014.                        protocol will be asked for.
  1015.         Optional data: None
  1016.  
  1017.         Type.........: 67
  1018.         Description..: Change user's phone number(s)
  1019.                        Allows the user to change his/her phone num-
  1020.                        ber(s).
  1021.         Optional data: None, /V or /D
  1022.                        The /V for Voice and the /D for Data numbers
  1023.                        can be used if you don't want SuperBBS to ask
  1024.                        the user for both telephone numbers. /V will
  1025.                        only ask for the voice number and /D will only
  1026.                        ask for the data phone number.
  1027.  
  1028.         Type.........: 68
  1029.         Description..: Select message area from arealist
  1030.                        Allows the user to change area with the build
  1031.                        in area change command. This will display a
  1032.                        two row list of all the available (to this
  1033.                        user) message areas. Use this for changing
  1034.                        areas when using menu templating.
  1035.         Optional data: None, /3, /N or /G=?
  1036.                        When no option is given, SuperBBS will show all
  1037.                        mail areas to the user to which he/she has
  1038.                        access. When the /G option is used in conjunc-
  1039.                        tion with a message group character, SuperBBS
  1040.                        will only show the mail areas belonging to that
  1041.  
  1042.                                                          > Continued >
  1043.         --------------------------------------------------------------
  1044.         SuperBBS v1.17 Documentation                          Page 123
  1045.  
  1046.  
  1047.                        group. For example /G=L will only show the
  1048.                        areas belonging to mailgroup L (as specified in
  1049.                        the area setup).
  1050.                        The /N option will ask directly for the area-
  1051.                        number, without showing the area list first.
  1052.                        Users who know which area they want will bene-
  1053.                        fit from the speed. Users who don't know which
  1054.                        area they want can just press ENTER and Super-
  1055.                        BBS will show the arealist.
  1056.                        The /3 option will show the arealist as it was
  1057.                        in SuperBBS before version 1.16. (Version 1.16
  1058.                        and up uses a standard 2 collum display.) You
  1059.                        will get three collum of areas with the /3
  1060.                        option. Please note that areanames should not
  1061.                        exceed 20 characters when using this option.
  1062.                        There is also an option to use an ANS/ASC file
  1063.                        for displaying the areanames. See for more
  1064.                        information the MSGAREA.A?? file. If this file
  1065.                        is found, SuperBBS will use this textfile
  1066.                        instead of the build in arealist.
  1067.  
  1068.         Type.........: 69
  1069.         Description..: Select file area from arealist
  1070.                        Allows users to change area with the build in
  1071.                        area change command. This will display a one
  1072.                        row list of all the available (to this user)
  1073.                        file areas. Use this for changing areas when
  1074.                        using menu templating.
  1075.         Optional data: None, /P or /2
  1076.                        If you use the /P, the change area command will
  1077.                        change into a pick area command for ANSI users
  1078.                        only. The user can select an area from the list
  1079.                        with the cursor control keys. Local users
  1080.                        should use the cursor control keys on the
  1081.                        numeric keyboard with NUMLOCK on. (The other
  1082.                        cursor keys are used to change the online
  1083.                        time). The /2 command will give you two rows
  1084.                        instead of the one single row when no optional
  1085.                        data is given. With this option, your area
  1086.                        names have to be shorter than 30 characters,
  1087.                        but it allows you to display twice as much
  1088.                        areas on screen at once.
  1089.  
  1090.         Type.........: 70
  1091.         Description..: Change alias
  1092.                        Allows the user to change his/her alias. Only
  1093.                        works if you allowed the use of an alias on
  1094.                        your system.
  1095.         Optional data: None
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.         --------------------------------------------------------------
  1102.         SuperBBS v1.17 Documentation                          Page 124
  1103.  
  1104.  
  1105.         Type.........: 71
  1106.         Description..: List aliases
  1107.                        Shows an user - alias list of all users. The
  1108.                        user is given the option to select a search
  1109.                        criterium.
  1110.         Optional data: None
  1111.  
  1112.         Type.........: 72
  1113.         Description..: Show user's balance in the timebank
  1114.                        Allows the user to see how much time he/she has
  1115.                        deposit in the timebank. You can set a maximum
  1116.                        in the CONFIG.EXE program.
  1117.         Optional data: None
  1118.  
  1119.         Type.........: 73
  1120.         Description..: Deposit time in timebank
  1121.                        Allows the user to store time in the timebank.
  1122.         Optional data: None
  1123.  
  1124.         Type.........: 74
  1125.         Description..: Withdraw time from timebank
  1126.                        Allows the user to withdraw time from his/her
  1127.                        account.
  1128.         Optional data: None
  1129.  
  1130.         Type.........: 75
  1131.         Description..: User online / Other line status
  1132.                        Show's who is on the other line(s) or the cur-
  1133.                        rent status of the other line(s).
  1134.         Optional data: None </S>
  1135.                        If you leave the optional data field empty,
  1136.                        SuperBBS will show the user who is on the other
  1137.                        line(s). If you use the /S parameter, SuperBBS
  1138.                        will show you the status of the other line(s).
  1139.  
  1140.         Type.........: 76
  1141.         Description..: Send message to other user on-line
  1142.                        Allows the user on a line to send a on-line
  1143.                        message to a user on another line. This only
  1144.                        works if the 'Do not disturb' flag is not on.
  1145.         Optional data: None
  1146.  
  1147.         Type.........: 77
  1148.         Description..: Change current language
  1149.                        Allows the user to change his/her current lan-
  1150.                        guage file. (If you run with more than one
  1151.                        language file.)
  1152.         Optional data: None
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.         --------------------------------------------------------------
  1160.         SuperBBS v1.17 Documentation                          Page 125
  1161.  
  1162.  
  1163.         Type.........: 78
  1164.         Description..: Toggle 'Do not disturb' on/off
  1165.                        Allows the user to toggle the 'Do not disturb'
  1166.                        flag on and off. This way he/she can prevent
  1167.                        receiving messages from other line users.
  1168.         Optional data: None
  1169.  
  1170.         Type.........: 79
  1171.         Description..: Toggle full-screen message viewer on/off
  1172.                        Allows the user to toggle in SuperBBS the full-
  1173.                        screen message reader on or off. Quotes are now
  1174.                        written in a different colour when messages are
  1175.                        viewed with the fullscreen message viewer.
  1176.         Optional data: None
  1177.  
  1178.         Type.........: 80
  1179.         Description..: Displays mail areas with unread mail. All areas
  1180.                        which contains mail not yet read by the user
  1181.                        will be displayed. The menu option also tells
  1182.                        the user how many messages are unread and if
  1183.                        there are any personal unread messages.
  1184.         Optional data: None or /C
  1185.                        The /C option works on the user selected com-
  1186.                        bined boards (Message board 0). If you leave
  1187.                        the optional data field empty, it works on all
  1188.                        message areas.
  1189.  
  1190.         Type.........: 81
  1191.         Description..: This menu option allows the user to scan a file
  1192.                        for a virus infection. SuperBBS normally scans
  1193.                        uploads for viruses (if enabled), but now the
  1194.                        user can enter a filename of the file he/she
  1195.                        wants to scan. You will need the known ar-
  1196.                        chivers and the SCAN virusscanner somewhere in
  1197.                        your path.
  1198.         Optional data: /F or Full path
  1199.  
  1200.         Type.........: 82
  1201.         Description..: Allows the user to download the messages in the
  1202.                        QWK format, so he/she is able to read them
  1203.                        offline at his/her own pace.
  1204.         Optional data: None
  1205.  
  1206.         Type.........: 83
  1207.         Description..: Upload option for replies on the QWK messages
  1208.                        downloaded with the menu option 82. The upload
  1209.                        is done in a .REP file, which SuperBBS will
  1210.                        extract and than place the messages contained
  1211.                        in the .REP file in the correct areas, or the
  1212.                        default QWK area.
  1213.         Optional data: None
  1214.  
  1215.  
  1216.  
  1217.         --------------------------------------------------------------
  1218.         SuperBBS v1.17 Documentation                          Page 126
  1219.  
  1220.  
  1221.         Type.........: 84
  1222.         Description..: Allows the user to update his/her lastread
  1223.                        pointer, telling SuperBBS where to start
  1224.                        searching for new messages when downloading a
  1225.                        QWK packet.
  1226.         Optional data: None
  1227.  
  1228.         Type.........: 85
  1229.         Description..: Show an aphorism to the user. An aphorism, also
  1230.                        called 'fortune cookie' is a little text which
  1231.                        is funny or interesting or just a text. (Like
  1232.                        the laws of Murphy.) SuperBBS will randomly
  1233.                        display an aphorism from a file given in the
  1234.                        optional data field. This file has to be in a
  1235.                        certain format:
  1236.  
  1237.                             **
  1238.                             Life is great if you run SuperBBS!
  1239.                                  By: Frank Hemmelder
  1240.                             **
  1241.                             SuperBBS is now bugfree!
  1242.                                  By Aki Antman
  1243.  
  1244.                             SYSTEM ERROR: Disconnecting
  1245.                             **
  1246.  
  1247.                        The ** has to be the first two characters on
  1248.                        the line. They separate the aphorisms from each
  1249.                        other.
  1250.  
  1251.                        The ANSI/ASCII file APHORISM.A?? is displayed
  1252.                        before the aphorism itself. You can use all
  1253.                        control codes in the aphorism file, like all
  1254.                        colour codes and other options.
  1255.         Optional data: Drive:\Fullpath\Filename.ext (and /N)
  1256.                        The /N will suppress the 'press ENTER' line
  1257.                        after the aphorism is shown.
  1258.  
  1259.         Type.........: 86
  1260.         Description..: Execute the doornumber in the optional data
  1261.                        field or the current door in the configuration
  1262.                        program.
  1263.         Optional data: Doornumber or /D
  1264.                        When using the door template menu, use the /D
  1265.                        option to execute the door. When you want to
  1266.                        start a specific door, use the doornumber as
  1267.                        setup in the configuration menu. SuperBBS will
  1268.                        save the door information, so the user will be
  1269.                        returned to the same door the next time he
  1270.                        chooses the door menu.
  1271.  
  1272.  
  1273.  
  1274.  
  1275.         --------------------------------------------------------------
  1276.         SuperBBS v1.17 Documentation                          Page 127
  1277.  
  1278.  
  1279.         Type.........: 87
  1280.         Description..: Select a door from the list. Use this command
  1281.                        when working with the door template menu as set
  1282.                        in the configuration. This option will display
  1283.                        a list of all available (to the user) doors. If
  1284.                        his/her security is too low, or the user
  1285.                        doesn't have the correct flagsetting for a
  1286.                        door, this door won't be displayed in the list.
  1287.         Optional data: None or /R
  1288.                        The /R option will execute the selected door
  1289.                        automatically. this option is useful for pro-
  1290.                        grams which do not need a menu, but can be run
  1291.                        at once. Without the /R option, SuperBBS will
  1292.                        change to the template menu for the selected
  1293.                        door.
  1294.  
  1295.      |  Type.........: 88
  1296.      |  Description..: Browse the nodelist menu option. this allows
  1297.      |                 you and your users to search through the node-
  1298.      |                 lists, when compiled, for a certain address.
  1299.      |                 You will have to compile the nodelist with the
  1300.      |                 SBBSNODE.EXE program. (See the chapter on util-
  1301.      |                 ities.) This is the format when viewing:
  1302.      |
  1303.      |                 Z:?       = Display list of zones
  1304.      |                 2:?       = Display nets in zone 2
  1305.      |                 2:220/?   = Display nodes in zone 2 net 220
  1306.      |
  1307.      |  Optional data: None
  1308.  
  1309.         Type.........: 89
  1310.         Description..: This menu command is an area by area read com-
  1311.                        mand. You can read all unread messages in all
  1312.                        areas on behind each other. If there are no new
  1313.                        messages, SuperBBS will search for the next
  1314.                        area with new messages. You can always stop
  1315.                        reading after a message by pressing the corre-
  1316.                        sponding key for the Stop command. There is
  1317.                        also a command available to go to the next
  1318.                        area.
  1319.         Optional data: None
  1320.  
  1321.         Type.........: 90
  1322.         Description..: Attach a file to another user. This way a user
  1323.                        can send a file to another user. If local, the
  1324.                        file will be copied to the correct place, after
  1325.                        SuperBBS prompts for the filename. When used
  1326.                        remote, the user can upload the file by using
  1327.                        any protocol. This menu option allows the
  1328.                        transfer of the files privately. SuperBBS will
  1329.                        store the files in the Local Attach area, set
  1330.                        in the configuration program. (The LA directory
  1331.                        in the directory configuration.)
  1332.                                                          > Continued >
  1333.         --------------------------------------------------------------
  1334.         SuperBBS v1.17 Documentation                          Page 128
  1335.  
  1336.  
  1337.         Optional data: None or message area number
  1338.                        When using the optional message area number,
  1339.                        the user can leave a message to the receiver of
  1340.                        the file, telling him/her about the file. If no
  1341.                        optional area number is used, there is no mess-
  1342.                        age attach option for the user.
  1343.  
  1344.         Type.........: 91
  1345.         Description..: Check if the current user has some attached
  1346.                        files waiting. If there are files waiting, the
  1347.                        user will be told so and given the option to
  1348.                        download them. You can enable/disable the check
  1349.                        on local attach files from the configuration
  1350.                        program.
  1351.         Optional data: None
  1352.  
  1353.         Type.........: 92
  1354.         Description..: Select the archiver the user wants to use to
  1355.                        archive the .QWK packet with. Used with menu
  1356.                        option 82 and 83.
  1357.         Optional data: None
  1358.  
  1359.      |  Type.........: 93
  1360.      |  Description..: Sysop download function. This function allows
  1361.      |                 you to download a file from anywhere on the
  1362.      |                 system(s). Passwords set in the FILES.CTL file
  1363.      |                 are needed to download the password protected
  1364.      |                 files. Use this option with care.
  1365.      |  Optional data: None
  1366.  
  1367.         Type.........: 94
  1368.         Description..: Show users age graph. It will generate a graph
  1369.                        of all the users ages.
  1370.         Optional data: None or /S=?
  1371.                        When no optional data is given, SuperBBS will
  1372.                        start the graph at the age specified in the
  1373.                        configuration program. If the /S=? is used, you
  1374.                        can select at which age to start the graph, by
  1375.                        changing the parameter. For example /S=34 will
  1376.                        start the agegraph at the age of 34.
  1377.  
  1378.         Type.........: 95
  1379.         Description..: This menu command is used to either remove
  1380.                        files from the list of flagged files and to
  1381.                        show the flagged files in listform.
  1382.         Optional data: /S or None
  1383.                        When used with no optional data, this command
  1384.                        means remove a file from the flagged files
  1385.                        list. With the /S command it means that Super-
  1386.                        BBS will show the flagged files. Note the dif-
  1387.                        ference.
  1388.  
  1389.  
  1390.  
  1391.         --------------------------------------------------------------
  1392.         SuperBBS v1.17 Documentation                          Page 129
  1393.  
  1394.  
  1395.         Type.........: 98
  1396.         Description..: Toggle hotkeys on or off. Use this command to
  1397.                        allow your users to toggle the hotkey, that is
  1398.                        pressing a menu key will give a reaction with-
  1399.                        out having to press ENTER or no hotkeys, which
  1400.                        means you have to press ENTER after each com-
  1401.                        mand.
  1402.         Optional data: None
  1403.  
  1404.         Type.........: 99
  1405.         Description..: Chat between nodes. See also menu type 100 on
  1406.                        how to start a nodechat.
  1407.         Optional data: None
  1408.  
  1409.         Type.........: 100
  1410.         Description..: Create a conference for group chats. When a
  1411.                        user wants to use groupchat, he/she has to
  1412.                        create a (temporary) conference, which other
  1413.                        users can join. When the last user exits from
  1414.                        the conference, the conference is deleted.
  1415.                        (Only persons with Sysop level are able to make
  1416.                        conferences which are not deleted when the last
  1417.                        user logs off from the conference.) You should
  1418.                        have at least one permanent conference.
  1419.         Optional data: None or /D
  1420.                        When no optional data is given, a conference is
  1421.                        generated. When the /D option is given, a con-
  1422.                        ference can be deleted. (Except for permanent
  1423.                        conferences, which can only be deleted by
  1424.                        people with Sysop access.)
  1425.  
  1426.      |  Type.........: 101
  1427.      |  Description..: Leave a message comment which is shown to the
  1428.      |                 user writing a message to you when entering a
  1429.      |                 message in a local message area. This allows
  1430.      |                 your users to post a notice to other people
  1431.      |                 writing messages to them. The notice is dis-
  1432.      |                 played before the user starts writing the mess-
  1433.      |                 age. Note that the comment will be shown when
  1434.      |                 writing messages to the person who left the
  1435.      |                 note in all local message areas.
  1436.      |  Optional data: None or /R
  1437.      |                 When no optional data is specified, SuperBBS
  1438.      |                 will ask the user to leave a comment. With the
  1439.      |                 /R option filled in, it means remove the com-
  1440.      |                 ment from SuperBBS.
  1441.  
  1442.         That's it, all available menu commands. If you are convert-
  1443.         ing from RemoteAccess, Proboard or QuickBBS to SuperBBS,
  1444.         remember that there are different options available in Super-
  1445.         BBS, which the others do not have. Please check your configur-
  1446.         ation carefully if starting with SuperBBS.
  1447.  
  1448.  
  1449.         --------------------------------------------------------------
  1450.         SuperBBS v1.17 Documentation                          Page 130
  1451.  
  1452.  
  1453.         5.3       Menu templating
  1454.         --------------------------------------------------------------
  1455.  
  1456.         Maybe you remember the good old days. In those days you had to
  1457.         build a menu for every available message and file area. Those
  1458.         days are gone. Now there is menu templating. This means you
  1459.         have one menu for all your message areas, another for all
  1460.         your file areas and another for your doors. How does it work?
  1461.  
  1462.         First you design your menu. Then you enter all the needed
  1463.         information. But instead of entering messagebase numbers, you
  1464.         enter /M. SuperBBS will replace this with a message area
  1465.         number. The same for the file areas. Design your menu, enter
  1466.         the /F instead of the directory. SuperBBS will replace it with
  1467.         the information given in the CONFIG.BBS program. When design-
  1468.         ing your menu for doors, use the /D option, instead of the
  1469.         doorname.
  1470.  
  1471.         Let's have a look at how to setup a message menu this way:
  1472.  
  1473.         First you have to get from your main menu to the message menu.
  1474.         We want to start in area 01. We use menu option 1 and the
  1475.         optional data field would be: MAIL /M. MAIL is the menu
  1476.         name, /M tells SuperBBS to go to the message area last visited
  1477.         by the user. If he/she never visited a the mail areas, he/she
  1478.         will be placed in the first area defined in CONFIG.EXE. If you
  1479.         want to go to the second area, you could also have said /M=2.
  1480.  
  1481.         Now we need the read, write, scan, quickscan and delete
  1482.         options. Set up the menu as you normally would, except instead
  1483.         of using the messagebase number, use the /M in the optional
  1484.         data field. SuperBBS will know in what area the user is. Even
  1485.         if the user goes to the main menu and then returns to the
  1486.         messagebase, he/she will still be in the area he/she left
  1487.         from, because SuperBBS keeps track of the users movement.
  1488.  
  1489.         You can use the /M (/F for fileareas and /D for doors) for
  1490.         changing the area. If you use a type 1 menu and as optional
  1491.         data field the menu name and /M=+1, SuperBBS will change to
  1492.         the next area. If you use in the optional data field the
  1493.         /M=-1, SuperBBS will change area to the previous area. This
  1494.         option is endless, because the user is placed back to the
  1495.         first area when he/she wants to go to the next area from the
  1496.         last area. It looks like this:
  1497.  
  1498.               ---> 1 --> 2 --> 3 --> 4 --> 5 --> 6 --> 7 ---
  1499.               |                                            |
  1500.               ----------------------------------------------
  1501.  
  1502.         In this example is area 1 the lowest and area 7 the highest.
  1503.         This also works the other way around.
  1504.  
  1505.  
  1506.  
  1507.         --------------------------------------------------------------
  1508.         SuperBBS v1.17 Documentation                          Page 131
  1509.  
  1510.  
  1511.         So in short:
  1512.  
  1513.         Menu type  1 - MenuName /M    = Goto message area
  1514.         Menu type  2 - MenuName /F=31 = Gosub file area 31
  1515.         Menu type 23 - /M             = Read messages in current area
  1516.         Menu type 32 - /F             = Download from current area
  1517.         Menu type  1 - MenuName /M=+1 = Goto next message area
  1518.         Menu type  1 - Menuname /F=-1 = Goto previous file area
  1519.         Menu type  1 - MenuName /D    = Goto door menu
  1520.         Menu type  1 - MenuName /D=+1 = Goto next door menu
  1521.         Menu type 86 - /D             = Run current door
  1522.  
  1523.         To show the name and number of the area you are currently in
  1524.         use these codes:
  1525.  
  1526.         <Ctrl-K>4      = File area name in ANS/ASC files
  1527.         <Ctrl-K>5      = Message area name in ANS/ASC files
  1528.         <Ctrl-K>"      = Number of current message template area
  1529.         <Ctrl-K>#      = Number of current file template area
  1530.         <Ctrl-K>&      = Name of current door
  1531.         <Ctrl-K>/      = Number of current door
  1532.         @ (Ascii 64)   = File area name in menu textline
  1533.         ' (Ascii 96)   = Message area name in menu textline
  1534.  
  1535.         These codes are replaced with the name you have set up in the
  1536.         CONFIG.EXE program. If you use characters behind these codes,
  1537.         please think about the fact that the codes will be replaced by
  1538.         the area name, so you might have to check if your menu is
  1539.         still aligned the way you want it. Example:
  1540.  
  1541.         In your menu:       Area ^K#: @         SuperBBS HQ
  1542.         For the user:       Area 12: General area         SuperBBS HQ
  1543.  
  1544.         In this example the user is in file area 12, General area.
  1545.         Note that the control code should be entered by holding down
  1546.         the Control key and pressing the K key. The # is a normal
  1547.         character which should be entered without the control key
  1548.         being pressed.
  1549.  
  1550.         SuperBBS saves the template information, so the user will be
  1551.         put in the same template menu he/she was last in when calling
  1552.         the next time.
  1553.  
  1554.         5.4       Changing hardcoded menu options
  1555.         --------------------------------------------------------------
  1556.  
  1557.         SuperBBS has the option to allow the use of your own commands,
  1558.         instead of the hardcoded menus in SuperBBS. These options can
  1559.         be used for these menu commands:
  1560.  
  1561.              23   Read messages
  1562.              24   Scan messages
  1563.              25   Quickscan messages
  1564.  
  1565.         --------------------------------------------------------------
  1566.         SuperBBS v1.17 Documentation                          Page 132
  1567.  
  1568.  
  1569.         These are the available commands to replace the hardcoded box
  1570.         in SuperBBS. You need to set these options in the optional
  1571.         data field, when editing a menu.
  1572.  
  1573.              /F        Read messages in forward order
  1574.              /R        Read messages in reverse order
  1575.              /I        Read individual messages
  1576.              /N        Read new messages
  1577.              /S        Read selected messages
  1578.              /M        Read marked messages
  1579.              /O        Read n number of messages
  1580.  
  1581.         These options are also available in template menus, so you're
  1582.         able to build a very powerful (and in your own language if
  1583.         needed) message menu.
  1584.  
  1585.         Here is an example of a menu. The first /M is from the message
  1586.         area the second '/' option is to replace the hardcoded menu.
  1587.  
  1588.         Menu Opt. data Menu textline
  1589.         ---- --------  ----------------------------------------------
  1590.         23   /M /F     Read messages in forward order in current area
  1591.         23   /M /M     Read marked messages in current area
  1592.         24   8 /S      Read selected messages in area 8
  1593.         25   /M /N     Quickscan new messages in current area
  1594.         27   /M        Write a new message in current area
  1595.         68             Choose other area from area list
  1596.  
  1597.         And your imagination can do the rest. It is just an example,
  1598.         so don't use it as a complete menu!
  1599.  
  1600.         5.5       INCLUDE1.MNU
  1601.         --------------------------------------------------------------
  1602.  
  1603.         This is a very special menu file. This menu allows up to 10
  1604.         commands to be entered, which then will be added to all your
  1605.         existing menus. If SuperBBS finds this file in your menu
  1606.         directory, all menu commands are available to the user at any
  1607.         menu in your BBS. Very useful for the logoff command, paging
  1608.         the Sysop, help and what you can think of. Design the menu as
  1609.         you normally would design a menu.
  1610.  
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.         --------------------------------------------------------------
  1624.         SuperBBS v1.17 Documentation                          Page 133
  1625.  
  1626.  
  1627.         Chapter 6      Control codes
  1628.         ==============================================================
  1629.  
  1630.         6.1       Control codes in menu and textfiles
  1631.         --------------------------------------------------------------
  1632.  
  1633.         You can now use several control codes in your menu. They don't
  1634.         have to be displayed through an ANSI or ASCII file, but can be
  1635.         used on the menu textline itself.
  1636.  
  1637.         Here's a complete list of all the control codes you can use,
  1638.         either in an ANSI or ASCII file or in your menu textline:
  1639.         (^ = Ctrl key)
  1640.  
  1641.         ASCII     Char.     Function description
  1642.         --------- --------  -----------------------------------------
  1643.          1        ^A        Wait for ENTER key to be pressed
  1644.          2        ^B        Turns OFF aborting with S key
  1645.          3        ^C        Turns ON aborting with S key
  1646.          4        ^D        Turns ON the 'More' prompt
  1647.          5        ^E        Turns OFF the 'More' prompt
  1648.          6        ^F        Not used alone (See below)
  1649.          7        ^G        Generates a 'BEEP'
  1650.          8        ^H        Backspace
  1651.          9        ^I        Tabulator
  1652.         10        ^J        Linefeed
  1653.         11        ^K        Not used alone (See below)
  1654.         12        ^L        Clears screen
  1655.         13        ^M        Carriage return
  1656.  
  1657.         6.2       ^F codes
  1658.         --------------------------------------------------------------
  1659.  
  1660.         The ^F codes available: (All codes apply to current user!)
  1661.  
  1662.         ASCII     Char.     Function description
  1663.         --------- --------  -----------------------------------------
  1664.         6 65      ^FA       User's full name
  1665.         6 66      ^FB       User's city and state
  1666.         6 67      ^FC       User's password (Use with care!)
  1667.         6 68      ^FD       User's business/data phone number
  1668.         6 69      ^FE       User's home/voice phone number
  1669.         6 70      ^FF       User's last calling date
  1670.         6 71      ^FG       User's last calling time (24 hrs format)
  1671.         6 72      ^FH       User's A flagsetting
  1672.         6 73      ^FI       User's B flagsetting
  1673.         6 74      ^FJ       User's C flagsetting
  1674.         6 75      ^FK       User's D flagsetting
  1675.         6 76      ^FL       User's netmail credit
  1676.         6 77      ^FM       Number of messages user has written
  1677.         6 78      ^FN       Highest message number user has read
  1678.         6 79      ^FO       User's security level
  1679.         6 80      ^FP       User's number of calls
  1680.  
  1681.         --------------------------------------------------------------
  1682.         SuperBBS v1.17 Documentation                          Page 134
  1683.  
  1684.  
  1685.         6 81      ^FQ       User's uploads in files
  1686.         6 82      ^FR       User's uploads in KBytes
  1687.         6 83      ^FS       User's downloads in files
  1688.         6 84      ^FT       User's downloads in KBytes
  1689.         6 85      ^FU       Elapsed time this call in minutes
  1690.         6 86      ^FV       User's screen length
  1691.         6 87      ^FW       User's firstname
  1692.         6 88      ^FX       Status ANSI graphics (ON/OFF)
  1693.         6 89      ^FY       Status More prompt (ON/OFF)
  1694.         6 90      ^FZ       Status CLS codes (ON/OFF)
  1695.         6 48      ^F0       User's Sysop comment
  1696.         6 49      ^F1       Status Full Screen editor (ON/OFF)
  1697.         6 50      ^F2       User's age
  1698.         6 51      ^F3       User's birthday
  1699.         6 52      ^F4       User's time of first call (24 hrs format)
  1700.         6 53      ^F5       User's date of first call
  1701.         6 54      ^F6       Status of mailcheck at logon (ON/OFF)
  1702.         6 55      ^F7       User's up/download ratio in KBytes
  1703.         6 56      ^F8       User's up/download ratio in files
  1704.         6 57      ^F9       Status new files check at logon (ON/OFF)
  1705.         6 33      ^F!       Total minutes used
  1706.         6 34      ^F"       Status full screen reader
  1707.         6 35      ^F#       Expiration date
  1708.         6 36      ^F$       Expiration days left
  1709.         6 37      ^F%       Status of combined mail check
  1710.         6 38      ^F&       User's default protocol
  1711.         6 47      ^F/       Status of Hotkeys (ON/OFF)
  1712.  
  1713.         6.3       ^K codes
  1714.         --------------------------------------------------------------
  1715.  
  1716.         The ^K codes available:
  1717.  
  1718.         ASCII     Char.     Function description
  1719.         --------- --------  -----------------------------------------
  1720.         11 65     ^KA       Total number of calls to system
  1721.         11 66     ^KB       Name of the last caller
  1722.         11 67     ^KC       Number of active messages on system
  1723.         11 68     ^KD       Number of lowest message on system
  1724.         11 69     ^KE       Number of highest message on system
  1725.         11 70     ^KF       Number of times user has yelled SysOp
  1726.         11 71     ^KG       Day of the week in full
  1727.         11 72     ^KH       Number of users on system
  1728.         11 73     ^KI       Current time (24 hrs format)
  1729.         11 74     ^KJ       Current date (DD-MM-YY)
  1730.         11 75     ^KK       Number of minutes connected this call
  1731.         11 76     ^KL       Number of seconds connected this call
  1732.         11 77     ^KM       Number of minutes used against time limit
  1733.         11 78     ^KN       Number of seconds used against time limit
  1734.         11 79     ^KO       Number of minutes remaining this call
  1735.         11 80     ^KP       Number of seconds remaining this call
  1736.         11 81     ^KQ       Time Limit this call (Minutes)
  1737.         11 82     ^KR       User's baud rate (300-38400)
  1738.  
  1739.         --------------------------------------------------------------
  1740.         SuperBBS v1.17 Documentation                          Page 135
  1741.  
  1742.  
  1743.         11 83     ^KS       Abbreviated day of week
  1744.         11 84     ^KT       Download Limit in KBytes
  1745.         11 85     ^KU       Number of minutes until next system event
  1746.         11 86     ^KV       Time of next system event (24 hrs format)
  1747.         11 89     ^KY       User's maximum up/download ratio in KBytes
  1748.         11 90     ^KZ       User's maximum up/download ratio in files
  1749.         11 48     ^K0       Current language file description
  1750.         11 49     ^K1       Status of scroll lock
  1751.         11 50     ^K2       One second pause
  1752.         11 51     ^K3       Display securitylevel comment (LIMITS.BBS)
  1753.         11 52     ^K4       Name of the current filearea
  1754.         11 53     ^K5       Name of the current message area
  1755.         11 54     ^K6       User's alias
  1756.         11 55     ^K7       User's time in bank
  1757.         11 56     ^K8       User's number of calls today
  1758.         11 57     ^K9       Number of messages in current area
  1759.         11 33     ^K!       Status of do not disturb flag (ON/OFF)
  1760.         11 46     ^K.       Number of current node
  1761.         11 34     ^K"       Number of current message template area
  1762.         11 35     ^K#       Number of current file template area
  1763.         11 37     ^K%       User's download remaining today in KBytes
  1764.         11 38     ^K&       Name of the current door
  1765.         11 47     ^K/       Number of the current door
  1766.      |  11        ^K-       Number of flagged files
  1767.      |  11        ^K?       Size in KB of flagged files.
  1768.  
  1769.         Do not use the ^Q, ^S and ^Z commands, because these are
  1770.         dangerous and can give you unexpected problems. To enter a
  1771.         code in your textfiles, use the Ctrl-F command. This means,
  1772.         press the control key, hold down while pressing the mentioned
  1773.         key (in this example the F), release and press the second
  1774.         character (in case of the ^F and ^K keys.) Another way is
  1775.         holding down the ALT key and pressing the ASCII value from the
  1776.         numeric keypad on the right of the keyboard. This only works
  1777.         on EXTENDED keyboards!!
  1778.  
  1779.         6.4       ^X, ^C, ^P and ^A keys
  1780.         --------------------------------------------------------------
  1781.  
  1782.         There are four special control keys available. These have
  1783.         special functions in SuperBBS or the external utilities.
  1784.  
  1785.         The ^X key is used to run a program from an ANSI or ASCII
  1786.         file. If superBBS comes across an ^X code while displaying a
  1787.         file, it will execute the program behind the ^X code. For an
  1788.         example:
  1789.  
  1790.              ^XMYPROG.EXE
  1791.  
  1792.         This will start the MYPROG.EXE program when the file is dis-
  1793.         played where this code is in.
  1794.  
  1795.  
  1796.  
  1797.         --------------------------------------------------------------
  1798.         SuperBBS v1.17 Documentation                          Page 136
  1799.  
  1800.  
  1801.         The ^C, ^P and ^A key are used in the LCONFIG program and menu
  1802.         editor. The ^C code is used for changing colour in the text-
  1803.         lines in LCONFIG.EXE. (See the language configuration part of
  1804.         the docs for more info.) The ^A executes a display of a file
  1805.         in the language files. You can use this command to display an
  1806.         ANSI/ASCII file, instead of the normal textline. ^AHELP will
  1807.         display the file HELP.A?? from the textfile directory.
  1808.  
  1809.         The ^P key is used to enter another control code in the menu
  1810.         and/or textlines. You have to press ^P first, before you can
  1811.         enter a control code in a textline or menuline.
  1812.  
  1813.         6.5       ^O control codes
  1814.         --------------------------------------------------------------
  1815.  
  1816.         With the release of the 1.15 version of SuperBBS, a new set of
  1817.         control codes have been added to the program. These codes are
  1818.         accessed through the ^O key. You can use the ^O key to display
  1819.         the flagsettings of the user. Here's the commandline:
  1820.  
  1821.              ^O<Flag><Flag number>
  1822.  
  1823.         This will display the current user's flagsetting, either On or
  1824.         Off. For example ^OA5 will display the setting of flag A,
  1825.         number 5. With this option you can display all 32 flags.
  1826.  
  1827.         6.6       Additional control codes
  1828.         --------------------------------------------------------------
  1829.  
  1830.         Some additional control keys can be used within the message-
  1831.         base from SuperBBS. These codes are:
  1832.  
  1833.              @1   User's name
  1834.              @2   User's City & State
  1835.              @3   User's security level
  1836.              @4   User's birthday
  1837.              @5   User's age
  1838.              @6   User's firstname
  1839.  
  1840.         These codes can be used, if you did allow them to be used in
  1841.         CONFIG.EXE, in messages written in SuperBBS.
  1842.  
  1843.         The following additional control keys are needed for setting
  1844.         up a multiline system with template menus. These codes can be
  1845.         used in the data fields of the menus. The codes are:
  1846.  
  1847.              @N   Number of the node the user is on
  1848.              @M   Number of current message template area
  1849.              @F   Number of current file template area
  1850.              @G   Character of current message area group
  1851.              @S   User's security level
  1852.              @D   Number of the current template door
  1853.  
  1854.  
  1855.         --------------------------------------------------------------
  1856.         SuperBBS v1.17 Documentation                          Page 137
  1857.  
  1858.  
  1859.         These codes allow you to use the temporarily areas in a multi-
  1860.         line system. For example, name your temporarily directories
  1861.         TEMP1 and TEMP2, for line 1 and 2, and specify the optional
  1862.         data field with TEMP@N, which will be replaced by TEMP1 or
  1863.         TEMP2 depending on the node the user is on.
  1864.  
  1865.  
  1866.  
  1867.  
  1868.  
  1869.  
  1870.  
  1871.  
  1872.  
  1873.  
  1874.  
  1875.  
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.  
  1882.  
  1883.  
  1884.  
  1885.  
  1886.  
  1887.  
  1888.  
  1889.  
  1890.  
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.  
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.  
  1912.  
  1913.         --------------------------------------------------------------
  1914.         SuperBBS v1.17 Documentation                          Page 138
  1915.  
  1916.  
  1917.         Chapter 7.     Message base
  1918.         ==============================================================
  1919.  
  1920.         7.1       General information
  1921.         --------------------------------------------------------------
  1922.  
  1923.         The SuperBBS message base is fully compatible with QuickBBS
  1924.         and RemoteAccess. This will not guarantee that this will stay
  1925.         this way in the future. Either SuperBBS or the other programs
  1926.         might come up with a better type of message base. Currently
  1927.         you can use your old messagebase when converting from RA and
  1928.         QuickBBS to SuperBBS. You should set up the location of your
  1929.         messagebase in the CONFIG.EXE program.
  1930.  
  1931.         User's (and Sysop) are able to read, write, scan, quickscan
  1932.         and delete messages. The messages are numbered in increasing
  1933.         order. The first message starts at one, the second at two and
  1934.         so on. This doesn't mean both messages are in the same area.
  1935.         Besides the message number, SuperBBS also keeps track in which
  1936.         area the message belongs. When reading messages, you will see
  1937.         a notice stating that there are xxxx messages active. And that
  1938.         the lowest message is numbered yyyy and the highest zzzz. Also
  1939.         stated is the amount of messages in the current area. It looks
  1940.         something like this:
  1941.  
  1942.         Active msgs: 1234. Lowest message: 1. Highest message: 23460
  1943.         Number of messages in this area: 25.
  1944.  
  1945.         This means that from the 1234 messages, which starts at 1 and
  1946.         ends at 23460, there are 25 messages in the current area.
  1947.  
  1948.         SuperBBS now also supports real message numbering in an area.
  1949.         Every message area will be numbered from 1 to xx. This only
  1950.         applies to the user reading mail. Internally SuperBBS still
  1951.         uses the normal message numbering as described above.
  1952.  
  1953.         If you use this option of real message numbering, which we
  1954.         strongly suggest cause it is easier for your users to keep
  1955.         track of numbers while reading messages, you will have to
  1956.         change a line in the language file. This is the line stating
  1957.         the amount of messages in the messagebase. This has to be
  1958.         changed to the amount of messages per area. See the Lconfig
  1959.         part for more information.
  1960.  
  1961.         As of version 1.16, SuperBBS uses a new file to store the
  1962.         message areas in. This file is called BOARDS.BBS. You can have
  1963.         one file for all nodes, or have a file for every node. This
  1964.         way you can allow access to certain areas on certain lines.
  1965.         You can set this option in the configuration program (Path
  1966.         options). There is a little utility program to convert the
  1967.         information from the BOARDS.BBS file to the CONFIG.BBS file,
  1968.         so that external, non SuperBBS, programs can still be used.
  1969.         This utility is called BOARD2CF.EXE.
  1970.  
  1971.         --------------------------------------------------------------
  1972.         SuperBBS v1.17 Documentation                          Page 139
  1973.  
  1974.  
  1975.      |  Maximum number of areas is 200. Maximum number of messages in
  1976.      |  the messagebase is somewhere around 14000, although some
  1977.      |  echomail processors have a 12000 message limit.
  1978.      |
  1979.      |  When using the combined message area (area 0) there are some
  1980.      |  new options available to change the selected areas. You can
  1981.      |  now also specify 1-35 ON to select area 1 to 35. Or 34-40 OFF
  1982.      |  to deselect area 34 to 40. Any message number can be used
  1983.      |  here.
  1984.  
  1985.         7.2       Sysop keys available
  1986.         --------------------------------------------------------------
  1987.  
  1988.         The following options are available to the Sysop when reading
  1989.         messages:
  1990.  
  1991.         <A>gain             Show current message again.
  1992.         <N>ext              Show next message
  1993.         <B>ack              Show previous message
  1994.         <J>ump              Jump to specified message
  1995.         <R>eply             Reply to the current message
  1996.         <W>rite             Write a message in current area
  1997.         <D>elete            Remove the current message
  1998.         <K>eep as unread    Toggle the read/unread flag on/off
  1999.         <X>port             Send message to printer or file
  2000.         <C>opy              Copy current message to another user/board
  2001.      |  <E>dit              Edit the message information, like:
  2002.      |                      1. From        Who wrote the message
  2003.      |                      2. To          To whom message is send
  2004.      |                      3. Subject     Subject of the message
  2005.      |                      4. Board       Area number where msg is
  2006.      |                      5. Quit        Abort editing
  2007.      |                      6. Edit text   Edit the already saved text
  2008.      |                      7. Save        Save message
  2009.         <=>Private          Toggle the private/public flag on/off
  2010.         <S>top              Stop reading messages
  2011.      |  <U>pdate            Allows you to edit the senders user's in-
  2012.      |                      formation. You can use SBBSUSER.EXE or the
  2013.      |                      normal update procedure. Note that the
  2014.      |                      SBBSUSER.EXE option will only work while
  2015.      |                      in local mode. Note that SBBSUSER.EXE must
  2016.      |                      be found in your path to work properly.
  2017.  
  2018.         Use the <E>dit command and option 4 if you want to copy a
  2019.         message to another area. Use the <C>opy command if you want to
  2020.         forward a message to another user or system.
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.         --------------------------------------------------------------
  2030.         SuperBBS v1.17 Documentation                          Page 140
  2031.  
  2032.  
  2033.      |  Use the <E>dit command and option 6 when you want to edit the
  2034.      |  text in an already saved document. You can use the fullscreen
  2035.      |  editor, the suggested way, or use the line editor. Please note
  2036.      |  that not all fullscreen editors are capable of loading the old
  2037.      |  message directly into the editor. If your editor cannot read
  2038.      |  the message automatticaly, you will have to quote it back into
  2039.      |  the editor. Gedit, the fullscreen editor, is capable of load-
  2040.      |  ing the message in directly.
  2041.      |
  2042.      |  When copying messages, it is now possible to edit the message
  2043.      |  using the fullscreen editor.
  2044.  
  2045.         One undocumented option is available to Sysops when reading
  2046.         ECHO and NET mail, the <!>. This allows you to see the infor-
  2047.         mation normally hidden in a message through a Ctrl-A code.
  2048.         Information like path and kludges are normally hidden behind
  2049.         these codes.
  2050.  
  2051.         Please note that these commands may differ from language to
  2052.         language, because you can change them in the LCONFIG.EXE
  2053.         program.
  2054.  
  2055.         7.3       QWK offline mail system
  2056.         --------------------------------------------------------------
  2057.  
  2058.         SuperBBS is one of the first bulletin boards to support QWK
  2059.         packets directly. QWK is a mailreader system. this means the
  2060.         user downloads the messages and instead of reading them on-
  2061.         line, he/she can read them offline, saving a lot of money.
  2062.         Here's how it works.
  2063.  
  2064.         A user calls in on your board. he/she goes to the QWK menu
  2065.         options and selects the download command (menu option 82).
  2066.         First SuperBBS will ask the user if he/she wants to download
  2067.         the messages in QWK or ASCII format. (Most will choose QWK,
  2068.         sine it makes smaller packets.) Than SuperBBS will scan
  2069.         through the message areas for any unread mail in the areas the
  2070.         user selected. If there is new mail, SuperBBS will export the
  2071.         messages and put them in an archive. This user can download
  2072.         this archive. Offline, the user goes into the mail reader, for
  2073.         example the Silly Little Mail Reader or the BlueWave reader,
  2074.         which now also supports the QWK packets. He/she than reads the
  2075.         messages, write replies or/and new messages and on the next
  2076.         call uploads these messages with the upload command (menu
  2077.         option 83).
  2078.  
  2079.         Besides the mail package, your WELCOME.A?? and GOODBYE.A?? are
  2080.         packed in the archive. The same accounts for your NEWS.A??
  2081.         file, if available. These will be displayed while reading the
  2082.         messages with the SLMR program.
  2083.  
  2084.  
  2085.  
  2086.  
  2087.         --------------------------------------------------------------
  2088.         SuperBBS v1.17 Documentation                          Page 141
  2089.  
  2090.  
  2091.         SuperBBS will place the QWK packets in the WORK directory, as
  2092.         specified in your path settings in the configuration menu.
  2093.         Packets are deleted after the user has downloaded them.
  2094.  
  2095.         To separate your packets from those from other Bulletin board
  2096.         systems, you have to give the QWK packet an unique name. (Also
  2097.         done in the configuration program.) The reply packets will
  2098.         have the same name, except for the extension, which will be
  2099.         .REP, instead of the .QWK for the mailpacket.
  2100.  
  2101.         With menu option 84 is the user able to select where SuperBBS
  2102.         will start searching for new messages. This menu option allows
  2103.         to change the lastreadpointer of the user.
  2104.  
  2105.         Taglines can be allowed on your system. A tagline is a little
  2106.         line below the message with a witty or funny textline. Not all
  2107.         echomail areas allow the use of the tagline, because echomail
  2108.         already adds an origin line to the message, giving it a double
  2109.         originline, when a tagline is also added. You can select to
  2110.         use or not use taglines in the messagebase configuration menu
  2111.         per area.
  2112.  
  2113.         Selecting the areas you want the mail from is done through the
  2114.         use of the area select command for message area 0, the global
  2115.         message area. (Menu option 28.) Areas which are set to On will
  2116.         be used to export the mail from. Areas set to Off will not be
  2117.         scanned for mail. It is useful to put this menu option in your
  2118.         QWK menu screen.
  2119.  
  2120.         Since SuperBBS now allows longer names for the areas, a
  2121.         special short QWK name option has been added to the configur-
  2122.         ation of the messagebase.
  2123.  
  2124.         Support the offline mail reader and get your users to use it.
  2125.  
  2126.         7.4       Group messages
  2127.         --------------------------------------------------------------
  2128.  
  2129.         A very powerful way to send a message to every user or just a
  2130.         certain security level is the Group message function. If
  2131.         enabled, every user who logs on to your system will get the
  2132.         message as if it is addressed to him/her personally.
  2133.  
  2134.         You have to address the message to: *everyone*. In this case
  2135.         everybody will receive the message. If posted to a certain
  2136.         security number, like *everyone*100, only users with security
  2137.         level 100 will receive the message.
  2138.  
  2139.         Post a group message always as a private message, otherwise
  2140.         all users can read the message.
  2141.  
  2142.  
  2143.  
  2144.  
  2145.         --------------------------------------------------------------
  2146.         SuperBBS v1.17 Documentation                          Page 142
  2147.  
  2148.  
  2149.         There are two options available with menu option 22 (mail
  2150.         check), these options are:
  2151.  
  2152.              /A        Display all messages (New normal messages and
  2153.                        new group messages).
  2154.              /G        Display only new group messages.
  2155.  
  2156.         This message system could be used for informing your users
  2157.         about certain things happening on your BBS or any other infor-
  2158.         mation. You will have to set the security level needed to post
  2159.         group messages in the configuration program. This means you
  2160.         can also let your users send group messages.
  2161.  
  2162.         7.5       Netmail
  2163.         --------------------------------------------------------------
  2164.  
  2165.         SuperBBS is a fidonet compatible BBS program. This means you
  2166.         can exchange messages with other systems. These messages can
  2167.         be NETMAIL or ECHOMAIL.
  2168.  
  2169.         SuperBBS does use a nodelist, but you will still need a mailer
  2170.         who will handle the sending of the netmail, for example Front-
  2171.         door or D'Bridge.
  2172.  
  2173.         If you have setup a netmail directory, SuperBBS will ask you
  2174.         for the address the message has to be send to. Here you have
  2175.         to enter a valid fidonet address. If you don't know the
  2176.         address, you can browse through the nodelist and search for
  2177.         the node you want. If your replying to a message, SuperBBS
  2178.         will try to match the senders zone, if you have an AKA in the
  2179.         senders network. If SuperBBS can't match the senders zone, he
  2180.         will use the main address. After you supplied the destination
  2181.         address, SuperBBS will ask you if the message is a CRASH (or
  2182.         send immediately) message. Third and last question is about
  2183.         File attachments. You can send a file to another BBS this way.
  2184.         If you say YES to the previous question, SuperBBS will ask you
  2185.         for the filename. Then you can enter your message. Contact a
  2186.         BBS system running Netmail if you want more information on
  2187.         this subject. See the external utilities for more info on the
  2188.         SBBSNODE.EXE program.
  2189.  
  2190.         SuperBBS now also supports Point addresses, even if there is
  2191.         no nodelist available.
  2192.  
  2193.         7.6       Echomail
  2194.         --------------------------------------------------------------
  2195.  
  2196.         Echomail is mail that is distributed every night over several
  2197.         BBS systems. This means your message could get all over the
  2198.         world, depending on the area your in. This also is the most
  2199.         expensive form of mail. A message written on your system can
  2200.         be read on hundreds of other systems. All messages are always
  2201.         public.
  2202.  
  2203.         --------------------------------------------------------------
  2204.         SuperBBS v1.17 Documentation                          Page 143
  2205.  
  2206.  
  2207.         You can setup every message area in SuperBBS for echomail use.
  2208.         You can select a different AKA address (if you have them) and
  2209.         choose an origin line for every area (through ECHOORIG.CTL).
  2210.         You will need a front end program (also called mailer) to run
  2211.         Echomail.
  2212.  
  2213.         To run echomail you need an echomail processor. These will
  2214.         unpack messages from the archives they are send in and toss
  2215.         them to your echomail area. They also pack new messages from
  2216.         your system and prepare them to be transferred.
  2217.  
  2218.      |  Some processors are:
  2219.      |
  2220.      |       - ZmailH       Echo & Netmail scanner/tosser
  2221.      |       - TosScan      Echo & Netmail scanner/tosser
  2222.      |       - Imail        Echo & Netmail scanner/tosser
  2223.      |       - GEcho        Echo & Netmail scanner/tosser
  2224.      |       - Fmail        Echo & Netmail scanner/tosser
  2225.      |
  2226.      |  Gecho and Fmail now support SuperBBS completely. Please note
  2227.      |  that most echo/netmailprocessors need the messagebase files in
  2228.      |  the main BBS directory.
  2229.  
  2230.         There are more programs available. Ask for them at a BBS near
  2231.         you, running echomail. The D'Bridge mailer has net and echo-
  2232.         mail support build into the program and support SuperBBS.
  2233.  
  2234.         You will also need some echomail utility program. This program
  2235.         must be capable of linking messages, renumbering and deleting
  2236.         them. One of the best programs around is MBUTIL written by
  2237.         Gerard van der Land. This program can take care of all your
  2238.         echomail area maintenance and more. This is a seperate program
  2239.         and not included in the SuperBBS archive.
  2240.  
  2241.         7.7       Nodelist support
  2242.         --------------------------------------------------------------
  2243.  
  2244.         SuperBBS has a limited Nodelist support build in. Limited
  2245.         because the cost support is not yet available. SuperBBS uses
  2246.         the QuickBBS alike indexfiles. These are created with the
  2247.         SBBSNODE.EXE program. Their is a menu option available to
  2248.         browse through the nodelist. When entering echomail, you have
  2249.         the option to scan through the nodelist to find the address.
  2250.         SuperBBS support point addresses.
  2251.  
  2252.         If no nodelist is available, SuperBBS will still work and you
  2253.         can still sent netmail. Also point addresses are still sup-
  2254.         ported.
  2255.  
  2256.  
  2257.  
  2258.  
  2259.  
  2260.  
  2261.         --------------------------------------------------------------
  2262.         SuperBBS v1.17 Documentation                          Page 144
  2263.  
  2264.  
  2265.         7.8       Search userlist
  2266.         --------------------------------------------------------------
  2267.  
  2268.         When enabled in the configuration program, SuperBBS allows the
  2269.         user who entered a non-existing name in a local message area
  2270.         to scan through the userlist. You can toggle this function on
  2271.         and off in the configuration program.
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.         --------------------------------------------------------------
  2320.         SuperBBS v1.17 Documentation                          Page 145
  2321.  
  2322.  
  2323.         Chapter 8.     Files base
  2324.         ==============================================================
  2325.  
  2326.         8.1       General information
  2327.         --------------------------------------------------------------
  2328.  
  2329.         The filebase is just like SuperBBS messagebase compatible with
  2330.         RemoteAccess and QuickBBS. SuperBBS uses a FILES.BBS file to
  2331.         display the available files to the users. This file looks like
  2332.         this when viewed with a normal ASCII editor:
  2333.  
  2334.         Filename     Description
  2335.  
  2336.                      ^---- Cursor position 14
  2337.  
  2338.         SuperBBS will add the information like size and date if the
  2339.         file is found in the current area. If not, the word defined in
  2340.         the lconfig program for the word offline will be displayed
  2341.         instead of the date and size. The description has to start on
  2342.         character number 14. SuperBBS allows you to have more then one
  2343.         file description line. You can set this information in the
  2344.         CONFIG.EXE program. If you want to add a line with a text
  2345.         editor, use one who ends without putting a Ctrl-Z at the end
  2346.         of the document, start the extra description line with the
  2347.         ' >'(ASCII 32+62) sign. This will tell SuperBBS it is a file
  2348.         description line and will display it at the right place. (See
  2349.         the example in the part of this chapter concerning the up-
  2350.         loader name.)
  2351.  
  2352.      |  SuperBBS now also wraps the text around if the textline is
  2353.      |  longer than 45 characters. The wrapped text will be displayed
  2354.      |  at the right indent. You can set this in the configuration
  2355.      |  program. You can specify to which position the long lines are
  2356.      |  wrapped, giving you the option to make your FILES.BBS look
  2357.      |  more neat. Here's an example of how it was in 1.16:
  2358.      |
  2359.      |  SBBS_117.LZH   777777   01-02-1993 [00] SuperBBS programm for
  2360.      |                                     all users. Shareware.
  2361.      |  SNETDIFF.L00    23909   01-02-1993 [00] SuperNet nodediff
  2362.      |
  2363.      |  This is how you can make it look in 1.17:
  2364.      |
  2365.      |  SBBS_117.LZH   777777   01-02-1993 [00] SuperBBS programm for
  2366.      |                                          all users. Shareware.
  2367.      |  SNETDIFF.L00    23909   01-02-1993 [00] SuperNet nodediff
  2368.      |
  2369.      |  When using the new files scan, SuperBBS will overwrite the
  2370.      |  area name with the next one if there are no new files in the
  2371.      |  area. Fileflagging and archive/text view is also available
  2372.      |  during a new files scan.
  2373.  
  2374.  
  2375.  
  2376.  
  2377.         --------------------------------------------------------------
  2378.         SuperBBS v1.17 Documentation                          Page 146
  2379.  
  2380.  
  2381.         8.2       Extract and view option
  2382.         --------------------------------------------------------------
  2383.  
  2384.         SuperBBS allows you and your users to extract, view and repack
  2385.         a file while on-line. SuperBBS has support for ZIP, LZH, PAK,
  2386.         ARJ and ARC files. You can extract a file, view the contents
  2387.         of the file, read textfiles from within the file and repack
  2388.         only the wanted files, while discarding the rest. SuperBBS
  2389.         makes use for this option of the TEMP directory which you have
  2390.         to set up in CONFIG.EXE.
  2391.  
  2392.         After use, SuperBBS will clean the area in case the user
  2393.         doesn't and you have set the option on in CONFIG.EXE.
  2394.  
  2395.         8.3       Uploader to files.bbs
  2396.         --------------------------------------------------------------
  2397.  
  2398.         SuperBBS allows you to optional put the username of the upload
  2399.         in the files list. This only works if you have the use of the
  2400.         '>' character in the files base listing set to on. SuperBBS
  2401.         will put the name of the uploader as the last line of the
  2402.         description. It will look like this:
  2403.  
  2404.         SBBS_117.LZH  777777  15-jan-91  New SuperBBS release v1.17
  2405.                                          Full featured version.
  2406.                                          Uploader: Aki Antman
  2407.  
  2408.         This is what your users will see. In your files.bbs list it
  2409.         will look something like this:
  2410.  
  2411.         SBBS_117.LZH  New SuperBBS release v1.17
  2412.          >Full featured version.
  2413.          >Uploader: Aki Antman
  2414.  
  2415.         Some Sysops use this method to give you some more system
  2416.         security, because everybody can see which file is uploaded by
  2417.         whom, preventing them to send you trojanhorses or virusfiles.
  2418.  
  2419.         8.4       FILES.CTL
  2420.         --------------------------------------------------------------
  2421.  
  2422.         This file, which is a plain ASCII file, gives you control over
  2423.         the files in your filebase. It is possible to assign passwords
  2424.         to files, specify unwanted files and allow free files. Use
  2425.         this file as follows:
  2426.  
  2427.                        <Filename>     /FREE
  2428.                        <Filename>     /UNWANTED
  2429.                        <Filename>     /PWD=<password>
  2430.  
  2431.  
  2432.  
  2433.  
  2434.  
  2435.         --------------------------------------------------------------
  2436.         SuperBBS v1.17 Documentation                          Page 147
  2437.  
  2438.  
  2439.         You can use wildcards in the filenames. If you don't specify a
  2440.         directory, the option will work in all file areas. Here's an
  2441.         example:
  2442.  
  2443.                        SBBS_111.ZIP   /FREE
  2444.                        BETA_112.ZIP   /PWD=BETATEST /FREE
  2445.                        *.GIF          /UNWANTED
  2446.                        C:\TMP\ZIP.ZIP /FREE
  2447.  
  2448.         This will make the SBBS file free, protect the free file Beta
  2449.         with a password, tells users .GIF files are not welcome and
  2450.         makes the ZIP.ZIP in the TMP directory also free.
  2451.  
  2452.      |  8.5       File flagging & Archive view
  2453.      |  --------------------------------------------------------------
  2454.      |
  2455.      |  SuperBBS has file flagging build into the program. File flag-
  2456.      |  ging means you can select a file which you want to download,
  2457.      |  while viewing the newfiles list or normal file list. This
  2458.      |  command is part of the more prompt, which is shown when the
  2459.      |  screenlength is reached, or the end of the file is reached.
  2460.      |  You can select the key to use for this option in the language
  2461.      |  files by using LCONFIG.EXE. The user only has to select the
  2462.      |  commandkey and SuperBBS will ask which file to flag. Also
  2463.      |  available is a menu option, menu type 95, with two options to
  2464.      |  display the flagged files list and to delete files from the
  2465.      |  list. See the menu commands for more information.
  2466.      |
  2467.      |  When a user selects the download command, SuperBBS will check
  2468.      |  if the user flagged files and will ask the user if he/she
  2469.      |  wants to download these flagged files.
  2470.      |
  2471.      |  SuperBBS makes a Filedoor/EFT compatible file BBSTAGFL.? when
  2472.      |  a user flags a file. This file is written/read from the direc-
  2473.      |  tory of the current node.
  2474.      |
  2475.      |  A user can never flag more files than his/her downloadlimit
  2476.      |  would allow. SuperBBS will give a warning if the user wants to
  2477.      |  flag a file which would exceed the limit.
  2478.      |
  2479.      |  Also available in the more prompt line is the option to peek
  2480.      |  inside an archive. This is no extract command, it will just
  2481.      |  show the contents of the specified archive. SuperBBS will ask
  2482.      |  the user which file to show. It the file is a textfile, the
  2483.      |  user can view the textfile with this view option. When Super-
  2484.      |  BBS detects an archive the archive viewer is called and when
  2485.      |  it is a textfile, the file is displayed.
  2486.      |
  2487.      |  Please note that both options use full filenames, no wildcards
  2488.      |  are allowed here. File flagging has been improved in version
  2489.      |  1.17 of SuperBBS.
  2490.  
  2491.  
  2492.  
  2493.         --------------------------------------------------------------
  2494.         SuperBBS v1.17 Documentation                          Page 148
  2495.  
  2496.  
  2497.      |  8.6       Download counter
  2498.      |  --------------------------------------------------------------
  2499.      |
  2500.      |  SuperBBS has a build in download counter. This allows you to
  2501.      |  keep track of the number of downloads for each file. In the
  2502.      |  configuration program you will have to specify which charac-
  2503.      |  ters you want to use as brackets. (For example: [], () or <>)
  2504.      |  SuperBBS will keep track of the downloads and everytime a file
  2505.      |  is downloaded will update the counter. If no counter is avail-
  2506.      |  able, SuperBBS will add one. This makes your files.bbs file
  2507.      |  look like this (Using [] as brackets):
  2508.      |
  2509.      |  SBBS_115.ZIP  532267  15-jan-91  [17] SuperBBS version 1.15
  2510.      |                                   Full featured version
  2511.      |                                   Uploader: Aki Antman
  2512.      |  SDOC_115.ZIP  100001  15-jan-91  [02] SuperBBS documentation
  2513.      |                                   Uploader: Frank Hemmelder
  2514.      |  SUPERNET.A68   32180  15-jan-91  [00] New SuperNet nodelist
  2515.      |                                   Uploader: Robbert Roos
  2516.      |
  2517.      |  Please note that SuperBBS does fill out the counter when below
  2518.      |  the 10. Also new uploaded files will have a counter set to
  2519.      |  zero. Both options can be set in the configuration program.
  2520.  
  2521.         When you set the brackets option in the configuration program
  2522.         to spaces, the downloadcounter will be disabled.
  2523.  
  2524.         8.7       Default protocol
  2525.         --------------------------------------------------------------
  2526.  
  2527.         SuperBBS now allows your users to have a default protocol.
  2528.         This means that SuperBBS will not ask the user which protocol
  2529.         to use, but will go straight to the download start, if the
  2530.         user has selected a default protocol.
  2531.  
  2532.         Users can select a default protocol with menu command 97. (See
  2533.         menu commands). There is also an ANSI/ASCII file available to
  2534.         show the available protocols, instead of the normal protocol
  2535.         list. (See support files for more information.)
  2536.  
  2537.         New users can get the question to select a default protocol at
  2538.         their first logon, if enabled. Already existing users should
  2539.         use the menu command (97) to select a default protocol.
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.         --------------------------------------------------------------
  2552.         SuperBBS v1.17 Documentation                          Page 149
  2553.  
  2554.  
  2555.         Chapter 9.     Support files
  2556.         ==============================================================
  2557.  
  2558.         9.1       General information
  2559.         --------------------------------------------------------------
  2560.  
  2561.         SuperBBS uses a whole range of extra ANSI and ASCII support
  2562.         files. You can define these files yourself, or use the build
  2563.         in (English) messages. This way you can personalize your
  2564.         system. If a file is not available, SuperBBS will display a
  2565.         message of it's own, if needed.
  2566.  
  2567.         You can make these ANSI and ASCII files with a program like
  2568.         Thedraw. It even allows you to use animation in your ANSI
  2569.         files. Do remember that users are calling in and that a long
  2570.         screen build up will scare them away, or they switch to ASCII.
  2571.  
  2572.         SuperBBS will first look for the files in the ANSI/ASCII
  2573.         textfile directory specified in the language files, then in
  2574.         the text directory specified in the CONFIG.EXE program and if
  2575.         still no file is found, it will display the message of it's
  2576.         own, which is normally just a textline explaining what is
  2577.         going on.
  2578.  
  2579.         9.2       ANSI and ASCII Support files
  2580.         --------------------------------------------------------------
  2581.  
  2582.         These are the support files:
  2583.  
  2584.         Name.........: 0001 (0102, 0203......2223, 2324)
  2585.         Type.........: ANS/ASC
  2586.         Description..: File to be displayed at logon, between 00:00
  2587.                        and 01:00 hrs. This way you can setup a file
  2588.                        for every hour. 1516.ANS would be displayed
  2589.                        between 15:00 and 16:00 hrs.
  2590.  
  2591.         Name.........: ALIASASK
  2592.         Type.........: ANS/ASC
  2593.         Description..: This file is displayed at logon of a newuser
  2594.                        just before asking the alias he/she wants to
  2595.                        use. This file should contain some information
  2596.                        about the use of an alias on your board.
  2597.  
  2598.         Name.........: ALTNEWS
  2599.         Type.........: ANS/ASC
  2600.         Description..: This file is displayed to IEMSI users who
  2601.                        selected not to view the normal NEWS.A?? file.
  2602.                        This way you can still give them some news
  2603.                        information. This file is not shown to not
  2604.                        IEMSI users.
  2605.  
  2606.  
  2607.  
  2608.  
  2609.         --------------------------------------------------------------
  2610.         SuperBBS v1.17 Documentation                          Page 150
  2611.  
  2612.  
  2613.         Name.........: APHORISM
  2614.         Type.........: ANS/ASC
  2615.         Description..: Shown to the user before the aphorism (menu
  2616.                        option 85) is shown to the user.
  2617.  
  2618.      |  Name.........: B??????
  2619.      |  Type.........: ANS/ASC
  2620.      |  Description..: Shown to the user with the BPS rate as spe-
  2621.      |                 cified behind the B. B2400.A?? would be shown to
  2622.      |                 a 2400 BPS caller and B14400.A?? would be shown
  2623.      |                 to a 14400 BPS caller. You can make a file for
  2624.      |                 the following BPS rates:
  2625.      |
  2626.      |                             300
  2627.      |                            1200
  2628.      |                            2400
  2629.      |                            4800
  2630.      |                            7200
  2631.      |                            9600
  2632.      |                           12000
  2633.      |                           14400
  2634.      |                           16800
  2635.      |                           19200
  2636.      |                           38400
  2637.      |
  2638.      |                 Other BPS rates are not available within Super-
  2639.      |                 BBS.
  2640.  
  2641.         Name.........: BFAILED
  2642.         Type.........: ANS/ASC
  2643.         Description..: Shown to the user when he/she enters a wrong
  2644.                        birthday at the birthday verification check.
  2645.  
  2646.         Name.........: BIRTHDAY
  2647.         Type.........: ANS/ASC
  2648.         Description..: Shown when a user calls on his/her birthday.
  2649.  
  2650.         Name.........: BVERIFY
  2651.         Type.........: ANS/ASC
  2652.         Description..: Shown to the user when he/she is asked to give
  2653.                        his/her birthday as part of the system security
  2654.                        check.
  2655.  
  2656.         Name.........: DEFPROT
  2657.         Type.........: ANS/ASC
  2658.         Description..: Shown to the user instead of the normal build
  2659.                        in protocol list when the user has to select a
  2660.                        default protocol.
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.         --------------------------------------------------------------
  2668.         SuperBBS v1.17 Documentation                          Page 151
  2669.  
  2670.  
  2671.         Name.........: DNLDHRS
  2672.         Type.........: ANS/ASC
  2673.         Description..: Shown to a user who wants to download when
  2674.                        downloading is not allowed as specified in
  2675.                        CONFIG.EXE.
  2676.  
  2677.         Name.........: DPHONE
  2678.         Type.........: ANS/ASC
  2679.         Description..: Shown to the user when he/she enters a dupe
  2680.                        phonenumber and the configuration has been set
  2681.                        to disconnect the user after showing this file.
  2682.  
  2683.         Name.........: EDITHELP
  2684.         Type.........: ANS/ASC
  2685.         Description..: Shown to the user when he/she asks for help
  2686.                        within the message editor.
  2687.  
  2688.         Name.........: FGOODBYE
  2689.         Type.........: ANS/ASC
  2690.         Description..: Shown to the user when he/she decided to logoff
  2691.                        after a file transfer. Do not use the code
  2692.                        Ctrl-A (= Press return) in this screen, other-
  2693.                        wise the user can't use the automatic logoff,
  2694.                        because SuperBBS will wait for the return.
  2695.  
  2696.         Name.........: GOODBYE
  2697.         Type.........: ANS/ASC
  2698.         Description..: Shown to the user at logoff, just before the
  2699.                        modems disconnect.
  2700.  
  2701.         Name.........: LOGO
  2702.         Type.........: ANS/ASC
  2703.         Description..: Shown to the user before asking the user's name
  2704.                        at logon to your system. At this moment is
  2705.                        SuperBBS not aware which language a user is
  2706.                        using, so it uses the directory specified in
  2707.                        the first language file in LANGUAGE.CTL. If you
  2708.                        are using different languages, this file should
  2709.                        contain all available languages.
  2710.  
  2711.         Name.........: LOGONAGE
  2712.         Type.........: ANS/ASC
  2713.         Description..: Shown to the user when he/she is too young to
  2714.                        logon to your system, as set in the configur-
  2715.                        ation program.
  2716.  
  2717.         Name.........: LOGONFLA
  2718.         Type.........: ANS/ASC
  2719.         Description..: Shown to the user when he/she doesn't have the
  2720.                        correct flagsettings for login in on your sys-
  2721.                        tem, as specified in the configuration program.
  2722.  
  2723.  
  2724.  
  2725.         --------------------------------------------------------------
  2726.         SuperBBS v1.17 Documentation                          Page 152
  2727.  
  2728.  
  2729.         Name.........: LOGONPWD
  2730.         Type.........: ANS/ASC
  2731.         Description..: Shown to the user when he/she gives the wrong
  2732.                        password for logging on to your system, when
  2733.                        you have specified a global password in the
  2734.                        configuration program.
  2735.  
  2736.         Name.........: LOGONSEC
  2737.         Type.........: ANS/ASC
  2738.         Description..: Shown to the user when his/her security level
  2739.                        is not high enough to logon to your system, as
  2740.                        specified in the configuration program.
  2741.  
  2742.         Name.........: MAXPAGE
  2743.         Type.........: ANS/ASC
  2744.         Description..: Shown to the user when trying to page the Sysop
  2745.                        more times then specified in CONFIG.EXE.
  2746.  
  2747.         Name.........: MSGAREA
  2748.         Type.........: ANS/ASC
  2749.         Description..: Shown to the user at menu type 68, instead of
  2750.                        the normal build in area list.
  2751.  
  2752.         Name.........: NEWS
  2753.         Type.........: ANS/ASC
  2754.         Description..: File displayed to every user at logon. Useful
  2755.                        for newsflashes. Programs like SXNEWS are
  2756.                        easy for creating and editing this file. When a
  2757.                        user uses IEMSI to login, he/she can select to
  2758.                        not view this file. (See also the ALTNEWS
  2759.                        file.) SuperBBS now allows you to select if you
  2760.                        want this file to be shown to the user every
  2761.                        time somebody logs on, or just when it is
  2762.                        updated. SuperBBS will remember the date the
  2763.                        user last read the file and will show the news
  2764.                        file only if the date of the file is newer.
  2765.  
  2766.         Name.........: NEWS1
  2767.         Type.........: ANS/ASC
  2768.         Description..: File shown directly after the NEWS.A?? file.
  2769.  
  2770.         Name.........: NEWUSER1
  2771.         Type.........: ANS/ASC
  2772.         Description..: Shown to newusers after he/she has verified
  2773.                        his/her name and before the other logon ques-
  2774.                        tions are asked. At this point does SuperBBS
  2775.                        not know which language the user wants to use,
  2776.                        so you should make this file contain all avail-
  2777.                        able languages.
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.         --------------------------------------------------------------
  2784.         SuperBBS v1.17 Documentation                          Page 153
  2785.  
  2786.  
  2787.         Name.........: NEWUSER2
  2788.         Type.........: ANS/ASC
  2789.         Description..: File displayed to a new user after he/she
  2790.                        answered the questions about system options and
  2791.                        selected a password, but before the NEWUSER.Q-A
  2792.                        questionnaire is answered.
  2793.  
  2794.         Name.........: NO300
  2795.         Type.........: ANS/ASC
  2796.         Description..: Shown to the user trying to logon to your BBS
  2797.                        at 300 Baud when this is not allowed as you
  2798.                        specified in the CONFIG.EXE file.
  2799.  
  2800.         Name.........: NOCHAT
  2801.         Type.........: ANS/ASC
  2802.         Description..: Shown to the user when his/her name is found in
  2803.                        the NOCHAT.CTL control file and the user tries
  2804.                        to use this option.
  2805.  
  2806.         Name.........: NOPAGE
  2807.         Type.........: ANS/ASC
  2808.         Description..: Shown to the user when you are paged, but you
  2809.                        disabled yell with the Scroll-lock key.
  2810.  
  2811.         Name.........: NOREMOTE
  2812.         Type.........: ANS/ASC
  2813.         Description..: Shown to the user when remote Sysops logins are
  2814.                        disabled and somebody tries to get in with your
  2815.                        name.
  2816.  
  2817.         Name.........: NOTAVAIL
  2818.         Type.........: ANS/ASC
  2819.         Description..: Shown to the user when you are paged outside
  2820.                        yelling hours.
  2821.  
  2822.         Name.........: NOTFOUND
  2823.         Type.........: ANS/ASC
  2824.         Description..: Shown to the user if the system can't find the
  2825.                        user's name in the user list. At this moment is
  2826.                        SuperBBS not aware of the language the user is
  2827.                        using or want to use. This file should there-
  2828.                        fore contain all available languages.
  2829.  
  2830.         Name.........: NOYELL
  2831.         Type.........: ANS/ASC
  2832.         Description..: Shown to the user when his/her name was found
  2833.                        in the NOYELL.CTL control file and the user
  2834.                        tries this option.
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.         --------------------------------------------------------------
  2842.         SuperBBS v1.17 Documentation                          Page 154
  2843.  
  2844.  
  2845.         Name.........: NUSERPWD
  2846.         Type.........: ANS/ASC
  2847.         Description..: File shown to the users when you have specified
  2848.                        a newuser password on your system. This file is
  2849.                        shown to the users before SuperBBS asks for the
  2850.                        password.
  2851.  
  2852.         Name.........: PAGEABRT
  2853.         Type.........: ANS/ASC
  2854.         Description..: Shown to the user when the Sysop aborts the
  2855.                        yell from the user.
  2856.  
  2857.         Name.........: PAGED
  2858.         Type.........: ANS/ASC
  2859.         Description..: Shown to the user after a yell for the Sysop,
  2860.                        incase the Sysop didn't answer.
  2861.  
  2862.         Name.........: PAGEQUES
  2863.         Type.........: ANS/ASC
  2864.         Description..: Shown to the user when yelling the Sysop, just
  2865.                        before the user is asked for the reason of the
  2866.                        page.
  2867.  
  2868.         Name.........: PASSWORD
  2869.         Type.........: ANS/ASC
  2870.         Description..: Shown to the new user just before the system
  2871.                        asks for a password, or just before the user
  2872.                        has the option to change his/her password.
  2873.  
  2874.         Name.........: PRIVATE
  2875.         Type.........: ANS/ASC
  2876.         Description..: Shown to the user if your system is a private
  2877.                        system and a non-registered user is trying to
  2878.                        get in. The user will be disconnected after
  2879.                        displaying the file.
  2880.  
  2881.         Name.........: RATIO
  2882.         Type.........: ANS/ASC
  2883.         Description..: Shown to the user when the upload/download file
  2884.                        ratio is exceeded as configured in CONFIG.EXE.
  2885.  
  2886.         Name.........: RATIOK
  2887.         Type.........: ANS/ASC
  2888.         Description..: Shown to the user when the upload/download
  2889.                        kbytes ratio is exceeded as configured in
  2890.                        CONFIG.EXE.
  2891.  
  2892.         Name.........: READHELP
  2893.         Type.........: ANS/ASC
  2894.         Description..: Shown to the user if he/she asks for help with
  2895.                        the read, scan and quickscan commands.
  2896.  
  2897.  
  2898.  
  2899.         --------------------------------------------------------------
  2900.         SuperBBS v1.17 Documentation                          Page 155
  2901.  
  2902.  
  2903.      |  Name.........: RULES
  2904.      |  Type.........: ANS/ASC
  2905.      |  Description..: File shown a specified number of times to new
  2906.      |                 users on your BBS system. Configuration about
  2907.      |                 the number of times the file is shown is in the
  2908.      |                 configuration program.
  2909.  
  2910.         Name.........: SECxxxxx
  2911.         Type.........: ANS/ASC
  2912.         Description..: Shown to the user just after the welcome screen
  2913.                        if he/she has the security level 'xxxxx'.
  2914.                        'xxxxx' has to be a value between 0 and 32000.
  2915.                        (SEC20.ANS will be shown to security level 20
  2916.                        user's.) If this file is not found, SuperBBS
  2917.                        will look for a SECALL.A?? file.
  2918.  
  2919.         Name.........: SECALL
  2920.         Type.........: ANS/ASC
  2921.         Description..: Shown to the user if for his/her security level
  2922.                        no SECxxxxx.A?? file is available.
  2923.  
  2924.      |  Name.........: SUBWARN
  2925.      |  Type.........: ANS/ASC
  2926.      |  Description..: Shown to the users who are within 31 days of
  2927.      |                 their expiration date.
  2928.  
  2929.         Name.........: TIMEWARN
  2930.         Type.........: ANS/ASC
  2931.         Description..: Shown to the user when his/her time is adjusted
  2932.                        due to an upcoming event.
  2933.  
  2934.         Name.........: TOOSLOW
  2935.         Type.........: ANS/ASC
  2936.         Description..: Shown to the user when trying to logon to the
  2937.                        system at a bps rate which is not fast enough,
  2938.                        as configured in CONFIG.EXE.
  2939.  
  2940.         Name.........: TRASHCAN
  2941.         Type.........: ANS/ASC
  2942.         Description..: Shown to the user when his/her name was found
  2943.                        in the TRASHCAN.CTL list. The user will be
  2944.                        disconnected after displaying the file.
  2945.  
  2946.         Name.........: VIP
  2947.         Type.........: ANS/ASC
  2948.         Description..: Shown to the user after the welcome screen if
  2949.                        his/her name was found in the VIP.CTL list.
  2950.  
  2951.         Name.........: WELCOME
  2952.         Type.........: ANS/ASC
  2953.         Description..: Shown to the user after he/she entered her name
  2954.                        and password.
  2955.  
  2956.  
  2957.         --------------------------------------------------------------
  2958.         SuperBBS v1.17 Documentation                          Page 156
  2959.  
  2960.  
  2961.         Name.........: WELCOME1
  2962.         Type.........: ANS/ASC
  2963.         Description..: Shown just after the welcome screen.
  2964.  
  2965.         Name.........: XFERHELP
  2966.         Type.........: ANS/ASC
  2967.         Description..: Shown to the user when the user asks for help
  2968.                        with the transfer protocols and file transfer.
  2969.  
  2970.         Name.........: XFERPROT
  2971.         Type.........: ANS/ASC
  2972.         Description..: Shown to the user when he/she selects the down-
  2973.                        load option. This file will replace the normal
  2974.                        build in protocol list.
  2975.  
  2976.         9.3       .CTL, .LNG and .BBS Support files
  2977.         --------------------------------------------------------------
  2978.  
  2979.         Besides the ANSI and ASCII files, SuperBBS uses a couple of
  2980.         .CTL, .LNG and .BBS files to control his behaviour. The .CTL
  2981.         files are all plain ASCII files and can be edited with every
  2982.         normal texteditor, even Edlin if you like. The .BBS files are
  2983.         all controlled through the CONFIG.EXE program. The .LNG files
  2984.         are language files and are controlled through the LCONFIG.EXE
  2985.         program. The .BBS and .LNG files are mentioned here as refer-
  2986.         ence, so you know what every file is for. Their set up is
  2987.         explained in detail in chapter 3.
  2988.  
  2989.         Type.........: *.LNG
  2990.         Description..: Language support files.
  2991.  
  2992.         Type.........: AREAS.BBS
  2993.         Description..: Not a file needed for SuperBBS, but most
  2994.                        echomail processors need this file, that's why
  2995.                        we mention it. It contains information about
  2996.                        your message areas and who to send them to. The
  2997.                        format is as follows:
  2998.  
  2999.                        <Area Nr.> <Description_of_area> <Destination>
  3000.  
  3001.                        Don't use the first three lines of the file.
  3002.                        Just put a ';' in there. This is just a plain
  3003.                        ASCII file.
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.         --------------------------------------------------------------
  3016.         SuperBBS v1.17 Documentation                          Page 157
  3017.  
  3018.  
  3019.         Type.........: ANSIF.CTL
  3020.         Description..: It is now possible to any text at logon to your
  3021.                        users. This is done by making an ASCII file
  3022.                        called ANSIF.CTL. SuperBBS will show all files
  3023.                        listed in this file to every user at logon. The
  3024.                        file looks like this:
  3025.  
  3026.                        LOGON
  3027.                        IMPORT
  3028.                        C:\SUPERBBS\SBBSHQ.TXT
  3029.  
  3030.                        If no extension is included, SuperBBS will show
  3031.                        the ANSI or ASCII file, depending on the user
  3032.                        settings. In our example SuperBBS would show
  3033.                        LOGON.ANS if the user has ANSI enabled, other-
  3034.                        wise LOGON.ASC would be shown. These files have
  3035.                        to be in the directories as specified by the
  3036.                        configuration of the language files. You can
  3037.                        show however every file you want by including
  3038.                        the path to the file, like the third file in
  3039.                        the example. The file will be displayed as the
  3040.                        DOS command TYPE would do, so viewing binary
  3041.                        files is not possible, but ANSI is possible.
  3042.  
  3043.         Type.........: BADALIAS.CTL
  3044.         Description..: Contains names which you as Sysop don't want to
  3045.                        be used as aliases on your system. The format
  3046.                        of this ASCII file is:
  3047.  
  3048.                             Bad alias
  3049.                             Bad alias
  3050.                             Bad alias
  3051.  
  3052.                        You can make this file with every normal ASCII
  3053.                        text editor.
  3054.  
  3055.         Type.........: BBSTAGFL.???
  3056.         Description..: Made by SuperBBS when a user flags a file for
  3057.                        download. This file is Filedoor/EFT compatible
  3058.                        and is written/read from in the directory of
  3059.                        the current node.
  3060.  
  3061.         Type.........: CONFIG.BBS
  3062.         Description..: Contains the complete setup from your system.
  3063.                        This file should never be deleted, because you
  3064.                        will have to setup your system again.
  3065.  
  3066.         Type.........: DOORS.BBS
  3067.         Description..: Configuration file for the doors you have set
  3068.                        up in the configuration program.
  3069.  
  3070.  
  3071.  
  3072.  
  3073.         --------------------------------------------------------------
  3074.         SuperBBS v1.17 Documentation                          Page 158
  3075.  
  3076.  
  3077.         Type.........: DORINFO?.DEF
  3078.         Description..: One of two files, the other is the EXITINFO.BBS
  3079.                        file, which contains information to be used by
  3080.                        programs running outside SuperBBS. These files
  3081.                        are generated when you do a type 7 or 15 exit.
  3082.  
  3083.         Type.........: ECHOORIG.CTL
  3084.         Description..: Plain ASCII file. With this file it is possible
  3085.                        to have a different origin line in every mail
  3086.                        area. The format of the file is as follows:
  3087.  
  3088.                        <AreaNr.> <Origin line>
  3089.                        <AreaNr.> <Origin line>
  3090.  
  3091.                        SuperBBS searches for this file in the direc-
  3092.                        tory where your BOARDS.BBS file is situated.
  3093.                        You can either edit this file with a normal
  3094.                        ASCII editor or through the configuration pro-
  3095.                        gram.
  3096.  
  3097.         Type.........: EXITINFO.BBS
  3098.         Description..: One of two files, the other is the DORINFO1.DEF
  3099.                        file, which contains information to be used by
  3100.                        programs running outside SuperBBS. These files
  3101.                        are generated when you do a type 7 or 15 exit.
  3102.  
  3103.         Type.........: FILES.CTL
  3104.         Description..: This file, which is a plain ASCII file, gives
  3105.                        you control over the files in your filebase. It
  3106.                        is possible to assign passwords to files, spec-
  3107.                        ily unwanted files and give free files. Use
  3108.                        this file as follows:
  3109.  
  3110.                        <Filename>     /FREE
  3111.                        <Filename>     /UNWANTED
  3112.                        <Filename>     /PWD=<password>
  3113.  
  3114.                        You can use wildcards in the filenames. If you
  3115.                        don't specify a directory, the option will work
  3116.                        in all file areas. Here's an example:
  3117.  
  3118.                        SBBS_111.ZIP   /FREE
  3119.                        BETA_112.ZIP   /PWD=BETATEST /FREE
  3120.                        *.GIF          /UNWANTED
  3121.                        C:\TMP\ZIP.ZIP /FREE
  3122.  
  3123.                        This will make the SBBS file free, protect the
  3124.                        free file Beta with a password, tells users
  3125.                        .GIF files are not welcome and makes the
  3126.                        ZIP.ZIP in the TMP directory also free.
  3127.  
  3128.  
  3129.  
  3130.  
  3131.         --------------------------------------------------------------
  3132.         SuperBBS v1.17 Documentation                          Page 159
  3133.  
  3134.  
  3135.         Type.........: FLSEARCH.BBS
  3136.         Description..: Contains all information about your file areas.
  3137.                        Location, securitylevels, flagsettings, age to
  3138.                        have access and if in the menu templating is
  3139.                        stored in this file.
  3140.  
  3141.         Type.........: LASTREAD.BBS
  3142.         Description..: Contains information about every user and
  3143.                        his/her lastread message number. Never delete
  3144.                        this file, because all message will be
  3145.                        displayed as new messages to the user's.
  3146.  
  3147.         Type.........: LIMITS.BBS
  3148.         Description..: Contains the information about userlevels and
  3149.                        their limits. SuperBBS checks this file to find
  3150.                        the information about the userlevels.
  3151.  
  3152.         Type.........: MSGIDX.BBS / MSGINFO.BBS / MSGTOIDX.BBS /
  3153.                        MSGHDR.BBS / MSGTXT.BBS
  3154.         Description..: Contains the information about the messages on
  3155.                        your system. If you want to start with a new
  3156.                        and empty database, delete these files.
  3157.  
  3158.         Type.........: NAMEIDX.BBS
  3159.         Description..: SuperBBS uses this file to make the userfile
  3160.                        search a lot faster. It is a small file used by
  3161.                        SuperBBS. Note that if you run non SuperBBS
  3162.                        software to pack/edit your userbase, you will
  3163.                        have to run USERPACK.EXE everytime after that
  3164.                        program. You can also switch the use of this
  3165.                        file of in the configuration program, but we
  3166.                        strongly suggest you do this only when nothing
  3167.                        else will work or you are having problems with
  3168.                        NAMEIDX.BBS searches.
  3169.  
  3170.         Type.........: NOAGECHK.CTL
  3171.         Description..: When a users name is found in this plain ASCII
  3172.                        control file, this user will be able to login
  3173.                        to your system, even when he/she would be too
  3174.                        young, as specified in the configuration of
  3175.                        your system. The format is similar to the
  3176.                        trashcan file.
  3177.  
  3178.         Type.........: NOBCHECK.CTL
  3179.         Description..: When a user logs on to your system and his/her
  3180.                        name is found in this plain ASCII control file,
  3181.                        he/she will never have to enter his/her birth-
  3182.                        day as a verification check. The file format is
  3183.                        the same as the trashcan file.
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.         --------------------------------------------------------------
  3190.         SuperBBS v1.17 Documentation                          Page 160
  3191.  
  3192.  
  3193.         Type.........: NOCHAT.CTL
  3194.         Description..: When a users name is found in this plain ASCII
  3195.                        file, this user is never able to use the node-
  3196.                        chat function. A file called NOCHAT.A?? will be
  3197.                        displayed to the user. The format is similar to
  3198.                        that of the trashcan file.
  3199.  
  3200.         Type.........: NODEIDX.SBS / NODEINC.SBS
  3201.         Description..: The two index files generated by the
  3202.                        SBBSNODE.EXE program from the raw nodelist.
  3203.                        These two files are needed if you use the node-
  3204.                        list support in SuperBBS.
  3205.  
  3206.         Type.........: NOYELL.CTL
  3207.         Description..: When a users name is found in this plain Ascii
  3208.                        control file, this user will not be able to
  3209.                        page the Sysop for a chat. The file NOYELL.A??
  3210.                        will be displayed to the user. The format is
  3211.                        similar to that of the trashcan file.
  3212.  
  3213.         Type.........: PFILES.BBS
  3214.         Description..: Contains information about private uploads done
  3215.                        to you. This is a normal ASCII file. All pri-
  3216.                        vate upload descriptions are stored in this
  3217.                        file.
  3218.  
  3219.         Type.........: PHONENUM.CTL
  3220.         Description..: This file prevents users from entering illegal
  3221.                        phonenumbers. It works the same way as the
  3222.                        trashcan file. When a phonenumber is entered,
  3223.                        it is compared to this list and when there is a
  3224.                        match, the user is warned. When a string is
  3225.                        found _anywhere_ in the entered phonenumber,
  3226.                        SuperBBS will react. Here is an example:
  3227.  
  3228.                        000-
  3229.                        -0000
  3230.                        06-11
  3231.  
  3232.                        Phonenumbers containing these strings
  3233.                        _ANYWHERE_ in the number will not be accepted.
  3234.                        For example 956-00001234 or 9006-110023 will
  3235.                        not be accepted by SuperBBS. Don't make your
  3236.                        control file to complex, use common sense.
  3237.  
  3238.         Type.........: SBBSBUSY.?
  3239.         Description..: This file is created by SuperBBS while running.
  3240.                        The ? is the node number. This file is even
  3241.                        created on single line systems. Since this file
  3242.                        is created in the common directory, check your
  3243.                        configuration.
  3244.  
  3245.  
  3246.  
  3247.         --------------------------------------------------------------
  3248.         SuperBBS v1.17 Documentation                          Page 161
  3249.  
  3250.  
  3251.         Type.........: SLCALLER.BBS
  3252.         Description..: Contains information about the last 15 users to
  3253.                        your BBS. You can delete this file if you want,
  3254.                        but there should be no reason for it.
  3255.  
  3256.         Type.........: SPROTO.BBS
  3257.         Description..: Configuration file for the external protocols.
  3258.  
  3259.         Type.........: SUSERS.BBS
  3260.         Description..: Contains the extra user information like age,
  3261.                        birthday, sex etc. Only delete this file if
  3262.                        your userbase is messy and you want to clean it
  3263.                        up. SuperBBS will ask every user for the needed
  3264.                        information again.
  3265.  
  3266.         Type.........: TIMELOG.BBS
  3267.         Description..: Contains information about the usage of the
  3268.                        BBS. The usage log is created out of this file.
  3269.                        If you want to start all over with your usage
  3270.                        log, delete this file.
  3271.  
  3272.         Type.........: TRASHCAN.CTL
  3273.         Description..: Contains user names you don't want to have on
  3274.                        your board, like Sysop, Dr., Hacker etc. This
  3275.                        is a plain ASCII file in the following format:
  3276.  
  3277.                             User name
  3278.                             User name
  3279.                             User name
  3280.  
  3281.         Type.........: USERDOES.?
  3282.         Description..: If SuperBBS finds the file USERDOES.?, where
  3283.                        the ? is the node number, in the main SuperBBS
  3284.                        directory, it will display it when menu type 75
  3285.                        is used. This file allows you to show a more
  3286.                        specific line when the user asks the status of
  3287.                        the other line. When this file contains "Play-
  3288.                        ing Tradewars", SuperBBS will show this if the
  3289.                        user executes menu type 75 (with /S option).
  3290.  
  3291.         Type.........: USERS.BBS
  3292.         Description..: Contains the information about the users. All
  3293.                        normal user information is stored in this file.
  3294.                        Only delete this file if you want to start with
  3295.                        0 user's. Backup this file often to prevent
  3296.                        damage to your userfile if something happens.
  3297.  
  3298.  
  3299.  
  3300.  
  3301.  
  3302.  
  3303.  
  3304.  
  3305.         --------------------------------------------------------------
  3306.         SuperBBS v1.17 Documentation                          Page 162
  3307.  
  3308.  
  3309.         Type.........: VIP.CTL
  3310.         Description..: Contains information about special users to
  3311.                        your BBS system. SuperBBS will show the file
  3312.                        VIP.A?? to them at logon. This is a plain ASCII
  3313.                        file with the following format:
  3314.  
  3315.                             <User name>
  3316.                             <User name>
  3317.                             <User name>
  3318.  
  3319.      |  Type.........: YELLTUNE.CTL
  3320.      |  Description..: You can define specific tunes for some users or
  3321.      |                 certain userlevels. The format of this file,
  3322.      |                 which is stored in the main SuperBBS directory
  3323.      |                 is:
  3324.      |
  3325.      |                      Name      Tune
  3326.      |                      Name      Tune
  3327.      |                      Security  Tune
  3328.      |
  3329.      |                 Here's an example:
  3330.      |
  3331.      |                      Aki Antman AKITUNE.CTL
  3332.      |                      200 SEC200.CTL
  3333.      |
  3334.      |                 This would play the tune set in AKITUNE.CTL
  3335.      |                 when Aki Antman would yell and it would play
  3336.      |                 the SEC200.CTL file when a user with level 200
  3337.      |                 would yell.
  3338.  
  3339.         SuperBBS uses four logfiles for storing system information.
  3340.         One type you hopefully never have to see. These files are:
  3341.  
  3342.         Type.........: ERRORS.LOG & ERRORS.BBS
  3343.         Description..: Contains all errors which occur during oper-
  3344.                        ation of SuperBBS. Please take note of these
  3345.                        files and send the information to us, when you
  3346.                        come across an error. Send this information to
  3347.                        our support nodes or the SuperBBS HQ.
  3348.  
  3349.         Type.........: SBBSDOWN.LOG
  3350.         Description..: Contains all downloads done from your system
  3351.                        and the names of the user who downloaded the
  3352.                        file.
  3353.  
  3354.         Type.........: SBBSUP.LOG
  3355.         Description..: Contains all uploads done to your system and
  3356.                        the name of the uploader.
  3357.  
  3358.  
  3359.  
  3360.  
  3361.  
  3362.  
  3363.         --------------------------------------------------------------
  3364.         SuperBBS v1.17 Documentation                          Page 163
  3365.  
  3366.  
  3367.         Type.........: SYSTEM.LOG
  3368.         Description..: Contains all information about what the user
  3369.                        did on your system. Information like name,
  3370.                        userlevel, alias, wrong passwords, exits to
  3371.                        doors and time on-line are stored in here. This
  3372.                        file is a plain ASCII file. If this file is
  3373.                        missing, SuperBBS will create it the next time
  3374.                        it is run, so you can delete this file as many
  3375.                        times as you wish.
  3376.  
  3377.  
  3378.  
  3379.  
  3380.  
  3381.  
  3382.  
  3383.  
  3384.  
  3385.  
  3386.  
  3387.  
  3388.  
  3389.  
  3390.  
  3391.  
  3392.  
  3393.  
  3394.  
  3395.  
  3396.  
  3397.  
  3398.  
  3399.  
  3400.  
  3401.  
  3402.  
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.  
  3409.  
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415.  
  3416.  
  3417.  
  3418.  
  3419.  
  3420.  
  3421.         --------------------------------------------------------------
  3422.         SuperBBS v1.17 Documentation                          Page 164
  3423.  
  3424.  
  3425.         Chapter 10.    Questionnaire language
  3426.         ==============================================================
  3427.  
  3428.         10.1      General information
  3429.         --------------------------------------------------------------
  3430.  
  3431.         SuperBBS has a powerful questionnaire language available to
  3432.         the Sysop for designing question files. SuperBBS will run the
  3433.         questionnaire called NEWUSER.Q-A if a new user enters your
  3434.         system and the file is found. Answers will be stored under the
  3435.         same filename, but with the extension .ASW. All questionnaires
  3436.         have to have the extension .Q-A and all answer files will have
  3437.         the extension .ASW. You can design as many questionnaires as
  3438.         you like. You can run a questionnaire from a menutype 12. On
  3439.         the optional datafield, you have to supply the name of the
  3440.         questionnaire.
  3441.  
  3442.         10.2      Available commands
  3443.         --------------------------------------------------------------
  3444.  
  3445.         Here's a list of the available commands in the questionnaires:
  3446.  
  3447.         Used codes:    <.......> = Mandatory
  3448.                        [.......] = Optional
  3449.  
  3450.         Command.....:  ASK <length> <variable> [default]
  3451.         Description.:  Asks for a string from the user. Length defines
  3452.                        the number of characters the answer can take,
  3453.                        the variable is the answer number, which you
  3454.                        can use in combination with other commands. The
  3455.                        option Default allows you to enter some infor-
  3456.                        mation as default in the answer field. If you
  3457.                        use as default USERNAME, this will be replaced
  3458.                        through the username of the user answering the
  3459.                        questionnaire.
  3460.         Example.....:  ASK 40 1 USERNAME
  3461.  
  3462.         Command.....:  CAPITALIZE <on/off>
  3463.         Description.:  If capitalize is on, all first letters of the
  3464.                        words entered in an answer field will be capi-
  3465.                        talized. If off, the user decides if a letter
  3466.                        is capitalized through the use of his/her
  3467.                        Shift(-Lock) key.
  3468.         Example.....:  CAPITALIZE ON
  3469.  
  3470.         Command.....:  CHANGECOLOR <foreground> <background>
  3471.         Description.:  Changes colour to the given combination. Fore-
  3472.                        ground (or textcolour) can be between 0 and 15,
  3473.                        background between 0 and 7. See earlier in this
  3474.                        documentation for a complete list of the col-
  3475.                        ours.
  3476.         Example.....:  CHANGECOLOR 14 1
  3477.  
  3478.  
  3479.         --------------------------------------------------------------
  3480.         SuperBBS v1.17 Documentation                          Page 165
  3481.  
  3482.  
  3483.         Command.....:  CLEARSCREEN
  3484.         Description.:  Clears the screen if user has selected CLS
  3485.                        codes.
  3486.         Example.....:  CLEARSCREEN
  3487.  
  3488.         Command.....:  DISPLAY <"text">
  3489.         Description.:  Displays a text to the user. The pipe symbol
  3490.                        '|' acts as a carriage return. Every textline
  3491.                        should not exceed the screen width. If no '|'
  3492.                        is given, SuperBBS will continue at the end of
  3493.                        the last line. Use the '|' also after the
  3494.                        GETCHOICE command as the first character of a
  3495.                        textline. You can use as many '|' symbols
  3496.                        behind each other as you like.
  3497.         Example.....:  DISPLAY "Welcome to this BBS system.|"
  3498.  
  3499.         Command.....:  DISPLAYASW <variable>
  3500.         Description.:  Shows the answer given to the question given as
  3501.                        the variable. This should be the same variable
  3502.                        as used with the question.
  3503.         Example.....:  DISPLAYASW 1
  3504.  
  3505.         Command.....:  DISPLAYFILE <filename>
  3506.         Description.:  Displays the file given as filename from the
  3507.                        textfile directory. If the user has ANSI
  3508.                        enabled this will be the ANSI version if avail-
  3509.                        able, otherwise the ASCII version is shown.
  3510.                        SuperBBS first looks in the directory specified
  3511.                        in the language file, then in the directory
  3512.                        specified in CONFIG.EXE.
  3513.         Example.....:  DISPLAYFILE WELCOME
  3514.  
  3515.         Command.....:  DOMENUC <menutype> <"data">
  3516.         Description.:  This command will run the menu command (see
  3517.                        list for numbers) given as data in the menutype
  3518.                        field. The information given in the data field
  3519.                        will be displayed to the user.
  3520.         Example.....:  DOMENUC 11 "Yelling Sysop"
  3521.  
  3522.         Command.....:  ENDIF
  3523.         Description.:  Use this command as the end of an IF loop. (See
  3524.                        the IF command.)
  3525.         Example.....:  ENDIF
  3526.  
  3527.         Command.....:  EXEC <command>
  3528.         Description.:  Executes the program given as the command
  3529.                        option. This allows you to execute an external
  3530.                        program. This program should be in the path or
  3531.                        current directory.
  3532.         Example.....:  EXEC USERCHEC.EXE
  3533.  
  3534.  
  3535.  
  3536.  
  3537.         --------------------------------------------------------------
  3538.         SuperBBS v1.17 Documentation                          Page 166
  3539.  
  3540.  
  3541.         Command.....:  GOTO <label>
  3542.         Description.:  This command allows you to jump to a character
  3543.                        or value. Label must be ONE character or a
  3544.                        value. The place GOTO will jump to is deter-
  3545.                        mined by the same character or value preceded
  3546.                        by a colon ':'. So the command GOTO A, will
  3547.                        jump to :A.
  3548.         Example.....:  GOTO B
  3549.  
  3550.         Command.....:  GETCHOICE <options> <variable> [default]
  3551.         Description.:  This command allows you to ask the user a ques-
  3552.                        tion, with only a limited one character answer
  3553.                        available. Options are the characters which are
  3554.                        valid for this answer, variable is the question
  3555.                        number the answer should be stored under in
  3556.                        memory and default is the default answer, so
  3557.                        when a user just presses ENTER, it will default
  3558.                        to the answer stated in default.
  3559.         Example.....:  GETCHOICE YN 2 Y
  3560.  
  3561.         Command.....:  IF <variable = "string">
  3562.         Description.:  This command allows you to jump over certain
  3563.                        parts of your questionnaire if the compiled
  3564.                        variable does not match the given string. Vari-
  3565.                        able is the question number stored in memory
  3566.                        and string is the string to match. SuperBBS
  3567.                        will compile the user's answer and compare it
  3568.                        to the string. If this doesn't match, SuperBBS
  3569.                        will jump to the first ENDIF found.
  3570.         Example.....:  IF 1 = "Frank Hemmelder"
  3571.  
  3572.         Command.....:  OUTPUTANSWER ["string"] <variable>
  3573.         Description.:  This commands allow you to store the answers
  3574.                        given by the user in an ASCII file with the
  3575.                        same name as the questionnaire, but with an ASW
  3576.                        extension. String is the text which should be
  3577.                        placed in front of the answer, variable is the
  3578.                        number of the answer stored in memory.
  3579.         Example.....:  OUTPUTANSWER "Full name : " 1
  3580.  
  3581.         Command.....:  POSTINFO
  3582.         Description.:  This command will write the current system
  3583.                        time, data and the username to the answer file.
  3584.                        This command should be used in front of the
  3585.                        OUTPUTANSWER lines. Some programs, like
  3586.                        READANS.EXE, allows you to upgrade newusers
  3587.                        easily by reading the answers in the
  3588.                        NEWUSER.ASW file, but they need the information
  3589.                        from POSTINFO to separate the different users.
  3590.         Example.....:  POSTINFO
  3591.  
  3592.  
  3593.  
  3594.  
  3595.         --------------------------------------------------------------
  3596.         SuperBBS v1.17 Documentation                          Page 167
  3597.  
  3598.  
  3599.         Command.....:  QUIT
  3600.         Description.:  Ends the questionnaire. This does not mean this
  3601.                        command has to be at the end of all the ques-
  3602.                        tions. If you use the IF and ENDIF commands,
  3603.                        this could be half way through your question-
  3604.                        naire.
  3605.         Example.....:  QUIT
  3606.  
  3607.      |  Command.....:  SETFLAG <flag> <on/off/toggle>
  3608.      |  Description.:  Allows you to change a flagsetting from the
  3609.      |                 current user. Flag should be a character/number
  3610.      |                 combination, flags are numbered A1 to D8, and
  3611.      |                 they should be followed by the on or off com-
  3612.      |                 mand or the toggle command. The toggle command
  3613.      |                 is used to switch the flagsetting around. For
  3614.      |                 example SETFLAG B6 TOGGLE will toggle the B6
  3615.      |                 flag.
  3616.      |  Example.....:  SETFLAG B5 TOGGLE
  3617.  
  3618.         Command.....:  SETSECURITY <level>
  3619.         Description.:  Allows you to change the userlevel. Level
  3620.                        should be the new level.
  3621.         Example.....:  SETSECURITY 0
  3622.  
  3623.         Command.....:  WAITENTER
  3624.         Description.:  This command displays the 'Press ENTER to
  3625.                        continue' string and waits for the user to
  3626.                        press the ENTER key. The 'Press ENTER....' will
  3627.                        be done in the current language.
  3628.         Example.....:  WAITENTER
  3629.  
  3630.         10.3      NEWUSER.Q-A & EXPIRED.Q-A
  3631.         --------------------------------------------------------------
  3632.  
  3633.         The NEWUSER.Q-A is run, when available, everytime a new user
  3634.         logs on to your system. Here you can ask questions like the
  3635.         address of the user, his/her requirements or anything else you
  3636.         would like to know, before you give access to your system. (An
  3637.         example is below.)
  3638.  
  3639.         The EXPIRED.Q-A is run everytime a user's expiration date has
  3640.         reached 0. In this questionnaire you can change levels, change
  3641.         flagsettings, tell the user how he can get his/her level back
  3642.         and many other things.
  3643.  
  3644.         You can use as many questionnaires as you might need, but
  3645.         these two are special.
  3646.  
  3647.  
  3648.  
  3649.  
  3650.  
  3651.  
  3652.  
  3653.         --------------------------------------------------------------
  3654.         SuperBBS v1.17 Documentation                          Page 168
  3655.  
  3656.  
  3657.         10.4      Questionnaire example
  3658.         --------------------------------------------------------------
  3659.  
  3660.         Now let's have a look at this little example. You could use
  3661.         it, but I recommend you change it and make it better. It will
  3662.         first display a textfile to the user, stating the rules of the
  3663.         BBS, then ask the most important questions and asks if you are
  3664.         a Sysop. If you are, you'll be able to enter your BBS informa-
  3665.         tion. Then all answers are displayed, so the user can check
  3666.         them and eventually start all over if he/she made a mistake.
  3667.         This is an example of a NEWUSER.Q-A questionnaire.
  3668.  
  3669.              CLEARSCREEN
  3670.              DISPLAYFILE RULES
  3671.              CHANGCOLOR 11 0
  3672.              CAPITALIZE ON
  3673.              DISPLAY "Do you still want to continue? (Y/n) "
  3674.              GETCHOICE YN 1 Y
  3675.              CAPITALIZE OFF
  3676.              IF 1 = "N"
  3677.              SETSECURITY 0
  3678.              CHANGECOLOR 14 4
  3679.              DISPLAY "You will be logged off now!"
  3680.              QUIT
  3681.              ENDIF
  3682.              :A
  3683.              CLEARSCREEN
  3684.              CHANGECOLOR 10 0
  3685.              DISPLAY "|Your full name........: "
  3686.              ASK 40 2 USERNAME
  3687.              CHANGECOLOR 10 0
  3688.              DISPLAY "Address................: "
  3689.              ASK 40 3
  3690.              CHANGECOLOR 10 0
  3691.              DISPLAY "City and State.........: "
  3692.              ASK 40 4
  3693.              CHANGECOLOR 10 0
  3694.              DISPLAY "Telephone number.......: "
  3695.              ASK 15 5
  3696.              CHANGECOLOR 10 0
  3697.              DISPLAY "|Are you a Sysop? (y/N) "
  3698.              CAPITALIZE ON
  3699.              GETCHOICE YN 6 N
  3700.              CAPITALIZE OFF
  3701.              IF 6 = "Y'
  3702.              CHANGECOLOR 10 0
  3703.              DISPLAY "BBS name...............: "
  3704.              ASK 40 7
  3705.              CHANGECOLOR 10 0
  3706.              DISPLAY "Telephone number.......: "
  3707.              ASK 15 8
  3708.              ENDIF
  3709.              CHANGECOLOR 13 0
  3710.  
  3711.         --------------------------------------------------------------
  3712.         SuperBBS v1.17 Documentation                          Page 169
  3713.  
  3714.  
  3715.              DISPLAY "|Thank you for filling out all the questions."
  3716.              DISPLAY "|Now you can check your answers.|
  3717.              WAITENTER
  3718.              CLEARSCREEN
  3719.              CHANGECOLOR 11 0
  3720.              DISPLAY "|These are your answers: "
  3721.              CHANGECOLOR 10 0
  3722.              DISPLAY "|Name..................: "
  3723.              DISPLAYASW 2
  3724.              CHANGECOLOR 10 0
  3725.              DISPLAY "Address................: "
  3726.              DISPLAYASW 3
  3727.              CHANGECOLOR 10 0
  3728.              DISPLAY "City and State.........: "
  3729.              DISPLAYASW 4
  3730.              CHANGECOLOR 10 0
  3731.              DISPLAY "Telephone number.......: "
  3732.              DISPLAYASW 5
  3733.              CHANGECOLOR 10 0
  3734.              IF 6 = "Y'
  3735.              CHANGECOLOR 10 0
  3736.              DISPLAY "BBS name...............: "
  3737.              DISPLAYASW 7
  3738.              CHANGECOLOR 10 0
  3739.              DISPLAY "Telephone number.......: "
  3740.              DISPLAYASW 8
  3741.              ENDIF
  3742.              CHANGECOLOR 14 1
  3743.              DISPLAY "|All answers correct? (Y/n)
  3744.              CAPITALIZE ON
  3745.              GETCHOICE YN 9 Y
  3746.              CAPITALIZE OFF
  3747.              IF 9 = "N"
  3748.              GOTO A
  3749.              ENDIF
  3750.              CHANGECOLOR 12 0
  3751.              DISPLAY "|Thank you for answering all questions."
  3752.              DISPLAY "|The answers are now stored."
  3753.              POSTINFO
  3754.              OUTPUTANSWER "Name.........: " 2
  3755.              OUTPUTANSWER "Address......: " 3
  3756.              OUTPUTANSWER "City & State.: " 4
  3757.              OUTPUTANSWER "Phone........: " 5
  3758.              IF 6 = "Y"
  3759.              OUTPUTANSWER "BBS name.....: " 7
  3760.              OUTPUTANSWER "Phone........: " 8
  3761.              QUIT
  3762.  
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.  
  3769.         --------------------------------------------------------------
  3770.         SuperBBS v1.17 Documentation                          Page 170
  3771.  
  3772.  
  3773.         Chapter 11.    Running SuperBBS
  3774.         ==============================================================
  3775.  
  3776.         11.1      General information
  3777.         --------------------------------------------------------------
  3778.  
  3779.      |  SuperBBS can be run as a stand alone program or with a front-
  3780.      |  end mailer like Intermail, Frontdoor, Portal of Power,
  3781.      |  D'Bridge or any other mailer program. In both cases you need
  3782.      |  to run SuperBBS from a batchfile. Examples are given further
  3783.      |  on in this documentation.
  3784.  
  3785.         If you are using SuperBBS with a mailer, please read all the
  3786.         documentation of the mailer program carefully, so you know how
  3787.         the two programs interact with each other.
  3788.  
  3789.         11.2      Command line options
  3790.         --------------------------------------------------------------
  3791.  
  3792.         SuperBBS can be started by running the program BBS.EXE without
  3793.         any parameter. This will put the main SuperBBS program on-
  3794.         line. You will see a SuperBBS screen with some information,
  3795.         like time and date, last user and more. When this screen is
  3796.         visible (or the screensaver is working) you have two options:
  3797.  
  3798.              [L]       This will put the BBS program in local mode.
  3799.                        This way you will be able to connect to the
  3800.                        system, just like you are running the system
  3801.                        remotely. Beware that if you have any door
  3802.                        programs installed which uses a Carrier Detect
  3803.                        monitor, these won't run because there is no
  3804.                        carrier signal available.
  3805.  
  3806.              [ESCAPE]  Shutdown SuperBBS and returns you to the DOS
  3807.                        prompt.
  3808.  
  3809.         There is a third option, this is that you get a caller on-
  3810.         line. SuperBBS will connect at the right modem speed and will
  3811.         handle the connection. A carrier check is build in, so if the
  3812.         user disconnects, the system will restart (if run from a
  3813.         batchfile).
  3814.  
  3815.         To start the BBS program in local mode, use the -L option.
  3816.         This option and the other command line options are as follows:
  3817.  
  3818.         Type.........: -Bxxxx
  3819.         Description..: Starts SuperBBS with a BPS rate of xxxx. This
  3820.                        is a value between 300 and 38400, depending on
  3821.                        your modemspeed. This option is mostly used in
  3822.                        a batchfile running a mailer, telling SuperBBS
  3823.                        at what BPS rate the user is calling.
  3824.  
  3825.  
  3826.  
  3827.         --------------------------------------------------------------
  3828.         SuperBBS v1.17 Documentation                          Page 171
  3829.  
  3830.  
  3831.         Type.........: -Exxx
  3832.         Description..: Tells SuperBBS to exit the call with errorlevel
  3833.                        xxx. This can be handy if you wish to start
  3834.                        some external program after SuperBBS finishes.
  3835.  
  3836.         Type.........: -L
  3837.         Description..: Starts the SuperBBS program in Local mode.
  3838.  
  3839.         Type.........: -Oxxxxxx
  3840.         Description..: This option will increase the overlay buffer
  3841.                        with xxxxxx bytes. (For a 286-12 Mhz machine
  3842.                        this should be somewhere between 50000 and
  3843.                        100000 bytes.) Experiment a bit with it to find
  3844.                        the right value. This will speed up the Super-
  3845.                        BBS operation on slow machines or machines with
  3846.                        no EMS. This option defaults to 50000 bytes.
  3847.  
  3848.         Type.........: -Px
  3849.         Description..: Tells SuperBBS what COM port to use for the
  3850.                        connection. You can use this command to over-
  3851.                        ride the settings in the configuration program.
  3852.                        Don't forget to use the -Px option also when
  3853.                        returning from a type 15 exit.
  3854.  
  3855.         Type.........: -R
  3856.         Description..: Tells SuperBBS it is already connected to a
  3857.                        caller and just has to restart the main pro-
  3858.                        gram. This option is used after a type 15 exit.
  3859.  
  3860.         Type.........: -T
  3861.         Description..: Tells SuperBBS the user has -T time left. This
  3862.                        time is forwarded by the mailer, to prevent an
  3863.                        overshoot of an event. Frontdoor uses this in
  3864.                        it's DOBBS.BAT file. (Frontdoor v2.01 has
  3865.                        a bug at 14400 EC, stating the -B command as
  3866.                        9600 Bps, instead of the correct Bps). See your
  3867.                        mailer manual for further information on call-
  3868.                        ing the BBS.
  3869.  
  3870.         Type.........: -*
  3871.         Description..: Tells SuperBBS not to load the overlay file in
  3872.                        EMS.
  3873.  
  3874.         Combinations of these parameters are possible. These parame-
  3875.         ters are not necessary to run the SuperBBS program, but are
  3876.         sometimes needed.
  3877.  
  3878.  
  3879.  
  3880.  
  3881.  
  3882.  
  3883.  
  3884.  
  3885.         --------------------------------------------------------------
  3886.         SuperBBS v1.17 Documentation                          Page 172
  3887.  
  3888.  
  3889.         11.3      On-line Sysop keys
  3890.         --------------------------------------------------------------
  3891.  
  3892.         While the SuperBBS is on-line and a caller is in the system,
  3893.         the sysop has several keys which he/she can use. All Fx keys
  3894.         refer to the status line which is shown at the bottom of the
  3895.         local screen. All keys apply to the current user on-line. All
  3896.         the available keys are:
  3897.  
  3898.         Type.........: F1
  3899.         Description..: Shows user's information on status line. Name,
  3900.                        city, bps rate, securitylevel, times called,
  3901.                        time left and line number are displayed.
  3902.  
  3903.         Type.........: F2
  3904.         Description..: Shows user's flags.
  3905.  
  3906.         Type.........: F3
  3907.         Description..: Shows user's up/download levels and ratio.
  3908.  
  3909.         Type.........: F4
  3910.         Description..: Shows chat reason (if any) and if the Sysop is
  3911.                        available.
  3912.  
  3913.         Type.........: F5
  3914.         Description..: Shows sysop comment (from SBBSUSER.EXE) and
  3915.                        alias information.
  3916.  
  3917.         Type.........: F6
  3918.         Description..: Shows the current time and date, user's phone
  3919.                        numbers, total calls to system, number of mess-
  3920.                        ages written and last caller.
  3921.  
  3922.         Type.........: F7
  3923.         Description..: Shows the last and first time and date the user
  3924.                        called, and the expiration date of the user.
  3925.  
  3926.         Type.........: F8
  3927.         Description..: Shows the information you have set in the con-
  3928.                        figuration program. This function key if
  3929.                        programmable by you. Note that the maximum line
  3930.                        length cannot be exceeded (80 characters). You
  3931.                        can use all control codes in these two lines.
  3932.  
  3933.         Type.........: F9
  3934.         Description..: Remove status lines from screen. This gives you
  3935.                        the same view as the user.
  3936.  
  3937.         Type.........: F10
  3938.         Description..: Gives information about the on-line keys
  3939.  
  3940.  
  3941.  
  3942.  
  3943.         --------------------------------------------------------------
  3944.         SuperBBS v1.17 Documentation                          Page 173
  3945.  
  3946.  
  3947.         Type.........: ALT-C
  3948.         Description..: Chat with the user. A message will be displayed
  3949.                        to the user at the start and finnish of the
  3950.                        conversation.
  3951.  
  3952.         Type.........: ALT-E
  3953.         Description..: Run the on-line user editor. This allows you to
  3954.                        edit the current user. All changes will be
  3955.                        saved in the user file. A message will be dis-
  3956.                        played to the user, unless you have CapsLock
  3957.                        on.
  3958.  
  3959.         Type.........: ALT-F
  3960.         Description..: Change the current user's flagsettings. All
  3961.                        changes will be saved in the user file. A mess-
  3962.                        age will be displayed to the user, unless you
  3963.                        have CapsLock on.
  3964.  
  3965.         Type.........: ALT-H
  3966.         Description..: Disconnect user without showing GOODBYE.A??.
  3967.  
  3968.      |  Type.........: ALT-J
  3969.      |  Description..: Shell to DOS from SuperBBS. SuperBBS can swap
  3970.      |                 to EMS or disk if allowed through the
  3971.      |                 CONFIG.EXE program. A message will be displayed
  3972.      |                 to the user when you shell out and when you
  3973.      |                 return. SuperBBS will remind you that you are
  3974.      |                 in a DOS shell.
  3975.  
  3976.         Type.........: ALT-L
  3977.         Description..: Locks the user out of your system. He/she will
  3978.                        be disconnected and his/her level will be
  3979.                        lowered to 0.
  3980.  
  3981.         Type.........: ALT-N
  3982.         Description..: Sysop next mode. This will halt the system
  3983.                        after the user currently online has logged of
  3984.                        for a short period and a beep will be heard.
  3985.                        This allows you as the Sysop to enter the BBS.
  3986.                        If after 45 seconds you did not react, the BBS
  3987.                        will be normally restarted. (Or your mailer
  3988.                        will be started.)
  3989.  
  3990.         Type.........: ALT-S
  3991.         Description..: Change the caller's security level. A message
  3992.                        will be displayed to the user, unless CapsLock
  3993.                        is on.
  3994.  
  3995.         Type.........: ALT-T
  3996.         Description..: Change the timelimit for the user for this
  3997.                        call.
  3998.  
  3999.  
  4000.  
  4001.         --------------------------------------------------------------
  4002.         SuperBBS v1.17 Documentation                          Page 174
  4003.  
  4004.  
  4005.         Type.........: ALT-1
  4006.         Description..: Generate line noise. This can be useful if you
  4007.                        want a user off-line.
  4008.  
  4009.         Type.........: ALT-2
  4010.         Description..: Toggle the ratio check for the current user on
  4011.                        or off.
  4012.  
  4013.         Type.........: ALT-3
  4014.         Description..: Set a new download limit for this call.
  4015.  
  4016.         Type.........: ALT-4
  4017.         Description..: Generates a BEEP on the user's console.
  4018.  
  4019.         Type.........: ALT-5
  4020.         Description..: Toggle output to user's screen on or off.
  4021.  
  4022.         Type.........: ALT-6
  4023.         Description..: Toggle user's keyboard on or off.
  4024.  
  4025.      |  Type.........: ALT-7
  4026.      |  Description..: Disables the current user from the online user
  4027.      |                 list. This option only works for the current
  4028.      |                 call.
  4029.  
  4030.         Type.........: Up arrow
  4031.         Description..: Increase time limit with 1 minute.
  4032.  
  4033.         Type.........: Down arrow
  4034.         Description..: Decrease time limit with 1 minute.
  4035.  
  4036.         Type.........: Scroll lock
  4037.         Description..: Toggle Sysop availability on/off. Status lock
  4038.                        on means Sysop not available. Also no messages
  4039.                        are send to the user, when the Sysop changes
  4040.                        the user information.
  4041.  
  4042.         11.4      User's on-line keys
  4043.         --------------------------------------------------------------
  4044.  
  4045.         Just as the Sysop has the user some special keys on-line.
  4046.         These are:
  4047.  
  4048.         Type.........: P
  4049.         Description..: Pause all output from text.
  4050.  
  4051.         Type.........: S
  4052.         Description..: Abort current operation. This works in most
  4053.                        places in the SuperBBS program.
  4054.  
  4055.         Type.........: Ctrl-C
  4056.         Description..: Stops Sysop yell and message scan.
  4057.  
  4058.  
  4059.         --------------------------------------------------------------
  4060.         SuperBBS v1.17 Documentation                          Page 175
  4061.  
  4062.  
  4063.         Type.........: Ctrl-Y
  4064.         Description..: Clears any input line. (When you have to answer
  4065.                        a question.)
  4066.  
  4067.         As of version 1.10, SuperBBS supports the 'normal' text editor
  4068.         keys as usable keys at input fields. This means you can use
  4069.         the arrow keys, Ctrl-T, Ctrl-Y, Insert, Delete, Home and End
  4070.         keys while entering text.
  4071.  
  4072.         11.5      Errorlevels
  4073.         --------------------------------------------------------------
  4074.  
  4075.         SuperBBS normally exits with an errorlevel. You can influence
  4076.         the 'normal' exit through the -Exxx command parameter (see
  4077.         above), but there are some more errorlevels reserved for
  4078.         SuperBBS. Here they are:
  4079.  
  4080.         Errorlevel...: 0
  4081.         Description..: Normal exit, no problems encountered.
  4082.  
  4083.         Errorlevel...: 2
  4084.         Description..: Sysop dropped to DOS by pressing ESCAPE in
  4085.                        stand alone mode.
  4086.  
  4087.         Errorlevel...: 3
  4088.         Description..: User logged off and entered Netmail.
  4089.  
  4090.         Errorlevel...: 4
  4091.         Description..: User logged off and entered Echomail.
  4092.  
  4093.         Errorlevel...: 5
  4094.         Description..: User logged off and entered both Net and Echo-
  4095.                        mail.
  4096.  
  4097.         In general it is useful not to use the errorlevel of 10 and
  4098.         below. These levels are mostly used to control program behav-
  4099.         iour.
  4100.  
  4101.         11.6      Yell and chat
  4102.         --------------------------------------------------------------
  4103.  
  4104.         SuperBBS has a chat option build in to the main program. When
  4105.         a user tries to yell for you, the SuperBBS program will ask
  4106.         for a reason. Then, if a reason is entered, the system will
  4107.         page you. Normally this is a creeping siren sound, but you can
  4108.         choose a melody through the use of YELLCFG.EXE. This program
  4109.         allows you to choose a page melody. You can even write your
  4110.         own tune, check the SBBSYELL.CFG file for an example. If you
  4111.         want to randomly change the tune every day, run the following
  4112.         option in your daily maintenance: YELLCFG.EXE CHANGE. This
  4113.         will take a different melody from the list every time it is
  4114.         run.
  4115.  
  4116.  
  4117.         --------------------------------------------------------------
  4118.         SuperBBS v1.17 Documentation                          Page 176
  4119.  
  4120.  
  4121.         The chat will be in two colours and if ANSI available it will
  4122.         be full screen by default. One window for the Sysop and one
  4123.         for the user. (Naturally only when user has ANSI on.) If the
  4124.         Sysop starts a chat, the user will get all the time spent in
  4125.         the chat back after ending the chat. If the user starts the
  4126.         chat, the time will continue.
  4127.  
  4128.         If you don't want the full screen chat, press the Left-Shift
  4129.         key, while pressing Alt-C or when you answer the chat.
  4130.  
  4131.         SuperBBS will display an ANSI/ASCII file before the user is
  4132.         asked for the reason to chat. This file is called PAGEQUES.A??
  4133.         and should be in your textfile directory.
  4134.  
  4135.         Five keys are available during a chat:
  4136.  
  4137.         Type.........: Ctrl-A
  4138.         Description..: Toggle capture file on/off
  4139.  
  4140.         Type.........: Ctrl-B
  4141.         Description..: Display an ANSI/ASCII file
  4142.  
  4143.         Type.........: Ctrl-Y
  4144.         Description..: Clears current line
  4145.  
  4146.         Type.........: Ctrl-R (in Fullscreen chat)
  4147.         Description..: Redraws the screen
  4148.  
  4149.         Type.........: Ctrl-W (in Fullscreen chat)
  4150.         Description..: Clears the your window
  4151.  
  4152.         The Sysop can end the chat with the ESCAPE key. Through the
  4153.         Ctrl-A key is it possible to keep a capture file for later
  4154.         reviewing of the chat.
  4155.  
  4156.      |  It is now possible to have a different yell tune for every
  4157.      |  user and/or security level. This is done in the YELLTUNE.CTL
  4158.      |  file. Here you specify for what securitylevel and/or what
  4159.      |  users you want a different tune. The format of this ASCII file
  4160.      |  is:
  4161.      |
  4162.      |  Name/Security level    Tune
  4163.      |  Name/Security level    Tune
  4164.      |
  4165.      |  For example:
  4166.      |
  4167.      |  Aki Antman             AKITUNE.CTL
  4168.      |  2500                   SEC2500.CTL
  4169.      |
  4170.      |  In combination with the menu option to yell outside the spec-
  4171.      |  ified page hours, this option allows your co-sysop for example
  4172.      |  to allways page you and you would be able to hear from the
  4173.      |  tune who it is.
  4174.  
  4175.         --------------------------------------------------------------
  4176.         SuperBBS v1.17 Documentation                          Page 177
  4177.  
  4178.  
  4179.         11.7      Alias system
  4180.         --------------------------------------------------------------
  4181.  
  4182.         SuperBBS allows a full alias system. The Sysop can select the
  4183.         use of an alias in all message areas. (Most echomail areas
  4184.         don't allow aliases.) Mailcheck at logon or after a menu type
  4185.         22 command, will be done for the user's real and alias name.
  4186.         No double aliases are allowed and SuperBBS checks this after a
  4187.         caller enters an alias.
  4188.  
  4189.         SuperBBS includes an option to view a list with real names and
  4190.         their aliases. The alias system only works if you set the
  4191.         option in the CONFIG.EXE program to Yes.
  4192.  
  4193.         11.8      View a certain file
  4194.         --------------------------------------------------------------
  4195.  
  4196.         An option in the user record is the field: File to view. Here
  4197.         you can specify per user a file which will be displayed to the
  4198.         user. You can select this file through the use of the
  4199.         SBBSUSER.EXE program. There is an option to allow the file to
  4200.         be deleted after viewing and only showing the file once.
  4201.  
  4202.         11.9      Menu to run
  4203.         --------------------------------------------------------------
  4204.  
  4205.         SuperBBS allows users to enter the system at another menu then
  4206.         the TOP.MNU menu. In the SBBSUSER.EXE program is a field for
  4207.         this option. Here you can enter the name of the menu the user
  4208.         wants to start at. SuperBBS will then pass the user directly
  4209.         to the menu given in the MenuToRun field. This menu can be
  4210.         different for every user. There is currently no automatic way
  4211.         to do this. You will have to adjust the userrecord yourself if
  4212.         you want this option available to your users.
  4213.  
  4214.         11.10     Expiration system
  4215.         --------------------------------------------------------------
  4216.  
  4217.         SuperBBS has an expiration system build in. There is a field
  4218.         in the SUSERS.BBS to store the date the expiration has to end.
  4219.         You could use this system to notify members of the expiration
  4220.         of their membership or something like that.
  4221.  
  4222.         When the date of expiration is reached and the user logs on
  4223.         again, he/she will see the questionnaire EXPIRED.Q-A, if
  4224.         available. In this file you can change the userlevel, flag-
  4225.         settings and other information.
  4226.  
  4227.         There is an option to add a certain amount of days to a new-
  4228.         user record. See the configuration part for more information.
  4229.  
  4230.         Two control codes are available to display the expiration
  4231.         date ^K# and the days till expiration ^F$.
  4232.  
  4233.         --------------------------------------------------------------
  4234.         SuperBBS v1.17 Documentation                          Page 178
  4235.  
  4236.  
  4237.         Chapter 12.    Multitasking and multiline
  4238.         ==============================================================
  4239.  
  4240.         12.1      General information
  4241.         --------------------------------------------------------------
  4242.  
  4243.         SuperBBS is able of running a system with more lines. We
  4244.         ask everybody who uses SuperBBS to give their opinion and
  4245.         ideas. That way we can expand and improve the multi-node
  4246.         option. SuperBBS currently uses 250 KByte memory per line.
  4247.         The setup explained here is for a system running a multitasker
  4248.         like Desqview or a system using a network, although drive
  4249.         names could change in a network configuration.
  4250.  
  4251.         There is a special document available on running multiline
  4252.         systems. Please check your support BBS for this file. It is
  4253.         called: MULTI-SB.xxx (where xxx is the archiver). This docu-
  4254.         ment is by Bob Henderson and contains examples of running a
  4255.         system with Desqview.
  4256.  
  4257.         12.2      Multiline configuration
  4258.         --------------------------------------------------------------
  4259.  
  4260.         The directory setup for the multi-node operations is a bit
  4261.         different from the single line systems. You will have to make
  4262.         a directory for every node you plan to run, even if it's only
  4263.         a local node. Your directory setup could look like this:
  4264.  
  4265.                   C:\SBBS
  4266.                   C:\SBBS\LINE1
  4267.                   C:\SBBS\LINE2
  4268.                   C:\SBBS\LINE3
  4269.                   C:\SBBS\MAIL
  4270.                   C:\SBBS\TEMP1
  4271.                   C:\SBBS\TEMP2
  4272.                   C:\SBBS\TEMP3
  4273.                   C:\SBBS\WORK1
  4274.                   C:\SBBS\WORK2
  4275.                   C:\SBBS\WORK3
  4276.                   C:\SBBS\NODELIST       (Optional)
  4277.                   C:\SBBS\ATTACH         (Optional)
  4278.                   E:\
  4279.  
  4280.         Place the executable programs in the SBBS directory and set
  4281.         your path statement pointing to this directory.
  4282.  
  4283.         You will have to setup a TEMP directory and a WORK directory
  4284.         for every line in use. The E:\ drive is a RAM disk and is the
  4285.         common directory for all nodes. You can also use a normal disk
  4286.         if no RAM drive is available. But a RAM disk is faster.
  4287.  
  4288.  
  4289.  
  4290.  
  4291.         --------------------------------------------------------------
  4292.         SuperBBS v1.17 Documentation                          Page 179
  4293.  
  4294.  
  4295.         Go into the line1 directory and start the config.exe program.
  4296.         The configuration program will start and you can setup all
  4297.         information needed, including file areas and limits. After you
  4298.         have finished, you will find some configuration files in your
  4299.         line1 directory. If you plan to use one single file area
  4300.         configuration list and one single limits configuration list,
  4301.         move the FLSEARCH.CTL and LIMITS.CTL files to the main direc-
  4302.         tory. Their they are accessible by all different lines.
  4303.  
  4304.         Now enter the second line directory and run config again. An
  4305.         option is to copy all files from the line1 directory to the
  4306.         second, third..... directory and then change the settings in
  4307.         the config by running the configuration program. You will have
  4308.         to change at least the directory setup. If using one single
  4309.         FLSEARCH.CTL and LIMITS.CTL file (see above), delete these
  4310.         files created in the line2 and line3.... directories. Config
  4311.         will create the FLSEARCH.CTL and LIMITS.CTL everytime you
  4312.         access the Limits and file area part of the configuration. If
  4313.         you like to change something in the two files, you first have
  4314.         to move them to one of the line directories, otherwise the
  4315.         files are newly created.
  4316.  
  4317.         You will have to create a LANGUAGE.CTL file in every line
  4318.         directory. These can all be the same or can differ from line
  4319.         to line. The *.LNG files you use can all be placed in the main
  4320.         SuperBBS directory.
  4321.  
  4322.         You now have to create the menu and textfiles. This is done in
  4323.         the same way as with a single line, although there are some
  4324.         special points to watch.
  4325.  
  4326.         When using a type 7 exit, you will have to tell the external
  4327.         program which line it is using. Have a look at the type 7
  4328.         optional data menu options for more information on this sub-
  4329.         ject. Most used command would be *N, telling the program which
  4330.         node it is running on. SuperBBS allows the use of the file
  4331.         DORINFO?.DEF, instead of the standard DORINFO1.DEF. The ques-
  4332.         tion mark will be replaced by the node number.
  4333.  
  4334.         When finished with the menus and textfiles, you can try the
  4335.         BBS by going into a line directory and entering BBS -L -N?
  4336.         (where the ? is the line number your working on). This will
  4337.         start the SuperBBS program in local mode on line?.
  4338.  
  4339.         You will now have to setup the multitakser, or the network
  4340.         software, to run the system multiline. Check your manual from
  4341.         the multitasker and/or network for more information on this
  4342.         subject.
  4343.  
  4344.         Please note that some external doors for SuperBBS can't handle
  4345.         the multiline setup. You might have to set up the program
  4346.         separately for every line.
  4347.  
  4348.  
  4349.         --------------------------------------------------------------
  4350.         SuperBBS v1.17 Documentation                          Page 180
  4351.  
  4352.  
  4353.         12.3      Multitaskers & networks
  4354.         --------------------------------------------------------------
  4355.  
  4356.         SuperBBS has been tested with these multitaskers (All trade-
  4357.         marks of their respective owners):
  4358.  
  4359.              - Desqview 2.25 (Normal and 386 versions)
  4360.              - Desqview 2.31
  4361.              - DoubleDos 4.0
  4362.              - Windows 3.1
  4363.              - OS/2
  4364.  
  4365.         SuperBBS support multitasking with Desqview. It will release
  4366.         time slicks and SBBSUSER will ask from Desqview what memory to
  4367.         use for direct screen writes.
  4368.  
  4369.         SuperBBS has been tested with a Lantastic network, Novell
  4370.         Netware and a Novell Light network. Please make sure that when
  4371.         using a network, SuperBBS has the correct rights to read/write
  4372.         in the different directories.
  4373.  
  4374.         12.4      Message base locking
  4375.         --------------------------------------------------------------
  4376.  
  4377.         SuperBBS has a message base locking system. Information about
  4378.         this locking system is available on request from the SuperBBS
  4379.         headquarters for third party programmers.
  4380.  
  4381.  
  4382.  
  4383.  
  4384.  
  4385.  
  4386.  
  4387.  
  4388.  
  4389.  
  4390.  
  4391.  
  4392.  
  4393.  
  4394.  
  4395.  
  4396.  
  4397.  
  4398.  
  4399.  
  4400.  
  4401.  
  4402.  
  4403.  
  4404.  
  4405.  
  4406.  
  4407.         --------------------------------------------------------------
  4408.         SuperBBS v1.17 Documentation                          Page 181
  4409.  
  4410.  
  4411.         Chapter 13     External specific SuperBBS utilities
  4412.         ==============================================================
  4413.  
  4414.         13.1      General information.
  4415.         --------------------------------------------------------------
  4416.  
  4417.         SuperBBS comes with a few external programs. These are:
  4418.  
  4419.              - USERPACK.EXE
  4420.              - SBBSUSER.EXE
  4421.              - SBBSUTIL.EXE
  4422.              - SBBSMENU.EXE
  4423.              - STOP.EXE
  4424.              - SBBSNODE.EXE
  4425.              - SNETMGR.EXE
  4426.              - BOARD2CF.EXE
  4427.  
  4428.         These programs are specially written for the use with Super-
  4429.         BBS. Other programs are available, but do not always support
  4430.         all SuperBBS functions.
  4431.  
  4432.         13.2      USERPACK.EXE
  4433.         --------------------------------------------------------------
  4434.  
  4435.         This program is designed to clean your user database. It will
  4436.         delete all users from the USER.BBS and SUSER.BBS files who
  4437.         have the DELETE flag on. The only exception are user's with
  4438.         the NO-KILL flag on. It will also pack your userdatabase for
  4439.         faster processing.
  4440.  
  4441.         Userpack allows multiple commandline parameters, but all
  4442.         parameters are optional. These are the available options:
  4443.  
  4444.         Type.........: -B
  4445.         Description..: Makes backup of the user files. This will take
  4446.                        the program longer to run than without this
  4447.                        option.
  4448.  
  4449.         Type.........: -Dxxx
  4450.         Description..: Deletes users from the list who haven't called
  4451.                        in xxx days.
  4452.  
  4453.         Type.........: -O
  4454.         Description..: Don't make backup copies if there is not enough
  4455.                        diskspace. Use this command in combination with
  4456.                        the -B option.
  4457.  
  4458.         Type.........: -R
  4459.         Description..: Removes backup copies after run is complete.
  4460.  
  4461.         Type.........: -Sxxx
  4462.         Description..: Deletes users with a securitylevel lower than
  4463.                        xxx.
  4464.  
  4465.         --------------------------------------------------------------
  4466.         SuperBBS v1.17 Documentation                          Page 182
  4467.  
  4468.  
  4469.         Type.........: ?
  4470.         Description..: Gives a short help screen. Use only as single
  4471.                        command line option.
  4472.  
  4473.         If you run userpack without any options, it will just pack
  4474.         your user base and delete every user with the DELETE flag on.
  4475.  
  4476.         13.3      SBBSUSER.EXE
  4477.         --------------------------------------------------------------
  4478.  
  4479.         This is the user editor for SuperBBS. You will be able to edit
  4480.         all available information in the user record. It is a full-
  4481.         screen program, with the function keys it uses displayed on
  4482.         the bottom line. Their are two modes (or windows). Edit mode
  4483.         and the main window. Edit mode allows you to change informa-
  4484.         tion from a caller. The main window is the command centre of
  4485.         the program. Here all function keys are active. From here you
  4486.         go to the edit window. These are the available keys:
  4487.  
  4488.         Key..........: Cursor keys
  4489.         Description..: Move around in the editmode of the program.
  4490.                        This will move you from edit field to edit
  4491.                        field.
  4492.  
  4493.         Key..........: Escape
  4494.         Description..: If in editing mode will ask you if you want to
  4495.                        save the information and leave the edit mode.
  4496.                        If in the main window, it will exit you to DOS.
  4497.  
  4498.         Key..........: Home
  4499.         Description..: Will move you to the first user when in the
  4500.                        main window.
  4501.  
  4502.         Key..........: End
  4503.         Description..: Will move you to the last user when in the main
  4504.                        window.
  4505.  
  4506.         Key..........: PgUp
  4507.         Description..: Will move you 10 users forward when in the main
  4508.                        window.
  4509.  
  4510.         Key..........: PgDn
  4511.         Description..: Will move you 10 users backwards when in the
  4512.                        main window.
  4513.  
  4514.         Key..........: F1
  4515.         Description..: Display help screens for SBBSUSER.
  4516.  
  4517.         Key..........: F2
  4518.         Description..: Goto general edit mode. This allows you to
  4519.                        change most information available. Changing the
  4520.                        security level fast is possible with the ALT-S
  4521.                        option.
  4522.  
  4523.         --------------------------------------------------------------
  4524.         SuperBBS v1.17 Documentation                          Page 183
  4525.  
  4526.  
  4527.         Key..........: F3
  4528.         Description..: Search for the user in the NEWUSER.ASW file and
  4529.                        display his/her answers. Useful if you want to
  4530.                        update users.
  4531.  
  4532.         Key..........: F4
  4533.         Description..: Search option. This allows you to search for
  4534.                        part of a name, alias, security level or city.
  4535.  
  4536.         Key..........: F5
  4537.         Description..: Put current user in window in the TRASHCAN.CTL
  4538.                        file.
  4539.  
  4540.         Key..........: F6
  4541.         Description..: Add a new user to the database.
  4542.  
  4543.         Key..........: F7
  4544.         Description..: Change the user's colour configuration.
  4545.  
  4546.         Key..........: F8
  4547.         Description..: Change the user's flagsettings.
  4548.  
  4549.         Key..........: F9
  4550.         Description..: Change the user's attributes. The delete flag
  4551.                        can also be set from the main window through
  4552.                        the ALT-D key.
  4553.  
  4554.         Key..........: F10
  4555.         Description..: Exit the program.
  4556.  
  4557.         Key..........: Shift-F1
  4558.         Description..: Add user to the VIP.CTL list.
  4559.  
  4560.         Key..........: Shift-F4
  4561.         Description..: Change the number of calls
  4562.  
  4563.      |  Key..........: Shift-F5
  4564.      |  Description..: Read any .ASW answer file
  4565.  
  4566.         With the numerical keys you can select an userrecord. Just
  4567.         enter the number of the record your looking for.
  4568.  
  4569.         SBBSUSER.EXE let's you edit the USER.BBS and SUSER.BBS file.
  4570.         Other user editors mostly allow only editing of the USER.BBS
  4571.         file.
  4572.  
  4573.  
  4574.  
  4575.  
  4576.  
  4577.  
  4578.  
  4579.  
  4580.  
  4581.         --------------------------------------------------------------
  4582.         SuperBBS v1.17 Documentation                          Page 184
  4583.  
  4584.  
  4585.         13.4      SBBSUTIL.EXE
  4586.         --------------------------------------------------------------
  4587.  
  4588.         SBBSUTIL.EXE allows you to convert some SuperBBS files to
  4589.         general QuickBBS type files. This is useful for some external
  4590.         programs which can't handle the specific SuperBBS type files.
  4591.         The program also gives you the option to initialize your file
  4592.         directories. All commands are done through the use of command-
  4593.         line parameters. Start the program as follows:
  4594.  
  4595.              SBBSUTIL.EXE <parameter>
  4596.  
  4597.         The parameters are:
  4598.  
  4599.         Type.........: FLSEARCH
  4600.         Description..: Converts SuperBBS FLSEARCH.BBS to FLSEARCH.CTL,
  4601.                        which can be used with RemoteAccess and/or
  4602.                        QuickBBS utilities.
  4603.  
  4604.         Type.........: LIMITS
  4605.         Description..: Converts SuperBBS LIMITS.BBS to LIMITS.CTL.
  4606.  
  4607.         Type.........: INITFILEAREAS
  4608.         Description..: Will initialize all file areas listed in the
  4609.                        file FLSEARCH.BBS. Here you can use three extra
  4610.                        parameters:
  4611.  
  4612.                             -F   Make FILES.BBS files if not
  4613.                                  available.
  4614.                             -D   Make DIR.BBS files if not available.
  4615.                             -A   Add all missing files, files which
  4616.                                  are in the directory, but not in the
  4617.                                  FILES.BBS list, to the FILES.BBS
  4618.                                  list.
  4619.  
  4620.         Running the util program with the option:
  4621.  
  4622.              SBBSUTIL.EXE <parameter> ?
  4623.  
  4624.         will display a little help screen for the available options.
  4625.  
  4626.      |  13.5      USERSORT.EXE
  4627.      |  --------------------------------------------------------------
  4628.      |
  4629.      |  This program has been completely rewritten by Pasi Talliniemi.
  4630.      |
  4631.      |  Usersort is a utility to sort your userbase. This can be done
  4632.      |  in several ways. The commandline is:
  4633.      |
  4634.      |       USERSORT [<option><direction> <option><direction> .... ]
  4635.      |
  4636.  
  4637.  
  4638.  
  4639.         --------------------------------------------------------------
  4640.         SuperBBS v1.17 Documentation                          Page 185
  4641.  
  4642.  
  4643.      |  The available options are:
  4644.      |
  4645.      |       Option:        Description:
  4646.      |       ------------   ---------------------------------------
  4647.      |       FIRST          First name
  4648.      |       LAST           Last name
  4649.      |       CITY           City
  4650.      |       SEC            Security level
  4651.      |       AGE            Age of user
  4652.      |       HIGHMSG        Highest message read
  4653.      |       MSGS           Messages posted
  4654.      |       CALLS          Number of calls
  4655.      |       DL-KB          Downloaded files in Kilobytes
  4656.      |       DL-TIMES       Downloaded files in number of files
  4657.      |       UL-KB          Uploaded files in Kilobytes
  4658.      |       UL-TIMES       Uploaded files in number of files
  4659.      |
  4660.      |  Every option can have a direction of sort given to the option.
  4661.      |  By default the sort is done in ascending order. Directions:
  4662.      |
  4663.      |       +              Ascending order (default)
  4664.      |       -              Descending order
  4665.      |
  4666.      |  Sysop is always placed at the beginning of the userlist.
  4667.      |  Here is an example:
  4668.      |
  4669.      |       USERSORT SEC- LAST+ FIRST+
  4670.      |
  4671.      |  This wil sort the userbase by security level in descending
  4672.      |  order (from highest to lowest). If the security level is the
  4673.      |  same the users are sorted on their lastname (from A to Z) and
  4674.      |  if these are the same the sort of the same last name users is
  4675.      |  done on their firstname (from A to Z).
  4676.  
  4677.         13.6      SBBSMENU.EXE
  4678.         --------------------------------------------------------------
  4679.  
  4680.         SuperBBS has it's own menu editor SBBSMENU.EXE. This is a
  4681.         complete menu editor for SuperBBS. It supports the multi-
  4682.         language aspects of SuperBBS. When you start the program, it
  4683.         should be in your directory containing the configuration
  4684.         files, you will be presented with the TOP.MNU menu if avail-
  4685.         able. Otherwise you will start in a new menu.
  4686.  
  4687.         Pressing [ESC] will display the menu. This menu has the fol-
  4688.         lowing options:
  4689.  
  4690.         Command......: Files
  4691.         Description..: Here you will be able to save, load, copy files
  4692.                        and do other maintenance functions.
  4693.  
  4694.  
  4695.  
  4696.  
  4697.         --------------------------------------------------------------
  4698.         SuperBBS v1.17 Documentation                          Page 186
  4699.  
  4700.  
  4701.         Command......: Text
  4702.         Description..: Here you will find the options which work on
  4703.                        the textpart of the menu.
  4704.  
  4705.         Command......: Commands
  4706.         Description..: Here you will find the options which work on
  4707.                        the menu options from the menu.
  4708.  
  4709.         Command......: Prompt
  4710.         Description..: Commands for the prompt, which will be visible
  4711.                        underneath the menu.
  4712.  
  4713.         Command......: Setup
  4714.         Description..: Setup commands for the menu editor.
  4715.  
  4716.         All menu commands will be described in detail below.
  4717.  
  4718.         13.6.1    File commands
  4719.         --------------------------------------------------------------
  4720.  
  4721.         Here are the commands you will find, when you enter the file
  4722.         menu of the SuperBBS menu editor.
  4723.  
  4724.         Command......: Load menu
  4725.         Description..: Loads a menu from the directory specified in
  4726.                        the current language file. You will be pres-
  4727.                        ented with a box stating what to look for.
  4728.                        (Mostly *.MNU files.) Enter the value you want,
  4729.                        or press ENTER and the editor will display a
  4730.                        list of the available menus. With the cursor
  4731.                        keys you can select a file. Pressing ENTER will
  4732.                        load the file.
  4733.  
  4734.         Command......: Save menu
  4735.         Description..: Saves the menu you are currently working on.
  4736.  
  4737.         Command......: New menu
  4738.         Description..: Start building a new menu. The editor will ask
  4739.                        you for a menu name.
  4740.  
  4741.         Command......: Write to
  4742.         Description..: Write the menu file to a specified name. This
  4743.                        option is useful if you want to use a menu to
  4744.                        build another. This way you can save a menu
  4745.                        with a different name.
  4746.  
  4747.         Command......: Rename
  4748.         Description..: Rename a menu in the directory. The editor will
  4749.                        ask you which menu to rename.
  4750.  
  4751.         Command......: Copy
  4752.         Description..: Copies a menu to another name. The editor will
  4753.                        ask you for the name of the menu to copy.
  4754.  
  4755.         --------------------------------------------------------------
  4756.         SuperBBS v1.17 Documentation                          Page 187
  4757.  
  4758.  
  4759.         Command......: Language
  4760.         Description..: Changes the language currently in use. This
  4761.                        allows you to quickly change menus for all
  4762.                        languages, without leaving the editor.
  4763.  
  4764.         Command......: DOS Shell
  4765.         Description..: Shell temporarily to DOS. You need to type EXIT
  4766.                        to return to the editor from DOS.
  4767.  
  4768.         Command......: Exit to DOS
  4769.         Description..: Exits the menu editor.
  4770.  
  4771.         13.6.2    Text commands
  4772.         --------------------------------------------------------------
  4773.  
  4774.         Please note that you now can use the ^Cxxx control code in the
  4775.         menu textfiles to make multicolored textlines. (xxx stands for
  4776.         the colour.)
  4777.  
  4778.         Command......: Edit text
  4779.         Description..: Change the text of the menu. Pressing ALT-F10
  4780.                        while in the text editor will display a help-
  4781.                        file.
  4782.  
  4783.         Command......: Simulate text
  4784.         Description..: The editor will show you what your menu will
  4785.                        look like if a user would see it. You will have
  4786.                        to enter a security level and flagsetting.
  4787.  
  4788.         Command......: Clear text
  4789.         Description..: Clears the current text screen.
  4790.  
  4791.         Command......: View text
  4792.         Description..: View a text belonging to the menu. This option
  4793.                        allows you to see files which are not part of
  4794.                        the menu, but will be displayed through the
  4795.                        ANSI/ASCII display file option in the menu.
  4796.  
  4797.         Command......: Run editor
  4798.         Description..: Enter an ANSI or ASCII text editor as you have
  4799.                        described in the setup of the SuperBBS menu
  4800.                        editor program.
  4801.  
  4802.         When you press ALT-F10 while you are in text edit, a help menu
  4803.         will be displayed. Here you will find all the commands avail-
  4804.         able to you.
  4805.  
  4806.         The use of extended ASCII characters is supported, so you can
  4807.         design lines and other graphics.
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.         --------------------------------------------------------------
  4814.         SuperBBS v1.17 Documentation                          Page 188
  4815.  
  4816.  
  4817.         13.6.3    Menu Commands
  4818.         --------------------------------------------------------------
  4819.  
  4820.         This is the important part of the SuperBBS editor. Here you
  4821.         specify the menu commands. You will find the following com-
  4822.         mands in this menu:
  4823.  
  4824.         Command......: Edit menu
  4825.         Description..: Edit a menu file. Here you enter the menu type,
  4826.                        securitylevel, hotkey and optional data.
  4827.  
  4828.         Command......: Text dump
  4829.         Description..: Dump the text to a printer.
  4830.  
  4831.         Command......: Menu dump
  4832.         Description..: Dump the menu information to a printer.
  4833.  
  4834.         When you press ALT-F10 while you are in menu edit, a help menu
  4835.         will be displayed. here you will find all the commands avail-
  4836.         able to you.
  4837.  
  4838.         Entering a menu is done through dialogue boxes for the menu
  4839.         type. If a menu type is not available in the menus given, you
  4840.         can use the option for 'other' menu types.
  4841.  
  4842.         13.6.4    Prompt
  4843.         --------------------------------------------------------------
  4844.  
  4845.         This menu option allows you to edit the prompt which is shown
  4846.         to the user. These commands are available:
  4847.  
  4848.         Command......: Edit prompt
  4849.         Description..: Change the text of the prompt. You can use
  4850.                        control codes in the prompt if you want.
  4851.  
  4852.         Command......: Change colours
  4853.         Description..: Change the colours of the prompt.
  4854.  
  4855.         13.6.5    Setup
  4856.         --------------------------------------------------------------
  4857.  
  4858.         This option allows you to setup the menu editor. You can
  4859.         specify an ANSI and ASCII text editor and the default prompt.
  4860.         The text editors will be called if you want to edit a text-
  4861.         file, so make sure they are in your path, or you specified the
  4862.         complete name.
  4863.  
  4864.         13.7      SBBSNODE.EXE
  4865.         --------------------------------------------------------------
  4866.  
  4867.         As of version 1.15, SuperBBS has nodelist support build in. It
  4868.         isn't a 100 % yet, the cost aspect isn't supported yet, but it
  4869.         is working.
  4870.  
  4871.         --------------------------------------------------------------
  4872.         SuperBBS v1.17 Documentation                          Page 189
  4873.  
  4874.  
  4875.         Before you can use the nodelist with SuperBBS, you will need
  4876.         to compile two index files. This is done with the SBBSNODE.EXE
  4877.         program. This program will create the files NODEINC.SBS and
  4878.         NODEIDX.SBS. Make sure you have set the directory settings
  4879.         correctly in the configuration program.
  4880.  
  4881.         SBBSNODE.EXE can compile up to 10 different nodelists. It will
  4882.         automatically search for the NODELIST.??? file and compile it.
  4883.         You can give the other files to compile as extra commandline
  4884.         options. Here is an example:
  4885.  
  4886.              SBBSNODE SUPERNET SIGNODES
  4887.  
  4888.         This will compile the latest NODELIST.???, SUPERNET.??? and
  4889.         SIGNODES.??? nodelists.
  4890.  
  4891.         Run the nodelist program every time you update your nodelists.
  4892.         This is very important.
  4893.  
  4894.         13.8      SNETMGR.EXE
  4895.         --------------------------------------------------------------
  4896.  
  4897.         This program has two functions. One for multiline systems and
  4898.         one for all systems. When run for the first time, you will be
  4899.         prompted for an ASCII editor, like Q.EXE. If you ever want to
  4900.         change the editor, delete the SNETMGR.CFG file.
  4901.  
  4902.      |  Included with SuperBBS v1.17 is a little program called
  4903.      |  SNOOPER.COM. This program works together with SNETMGR.EXE.
  4904.      |  With both programs you are able to monitor/use all remote work
  4905.      |  stations from one computer. To use this new remote maintenance
  4906.      |  system, you must load SNOOPER.COM on every workstation you are
  4907.      |  going to use with SNETMGR.EXE. SNOOPER.COM only works in a
  4908.      |  NETBIOS environment.
  4909.  
  4910.         13.8.1    Users online
  4911.         --------------------------------------------------------------
  4912.  
  4913.         This function of the SNETMGR.EXE program is only of use to
  4914.         multiline systems. It allows you to see the users online in
  4915.         every node, send messages to any combination of users or force
  4916.         any combination of nodes down with a selected errorlevel. The
  4917.         following keys are available:
  4918.  
  4919.              [CURSORKEYS]   Move around the nodes
  4920.  
  4921.              [SPACE]        Tag/untag node
  4922.  
  4923.              [S]            Send message to node
  4924.  
  4925.              [D]            Force node down with errorlevel
  4926.  
  4927.  
  4928.  
  4929.         --------------------------------------------------------------
  4930.         SuperBBS v1.17 Documentation                          Page 190
  4931.  
  4932.  
  4933.         When forcing a node down, SNETMGR.EXE will ask you for the
  4934.         errorlevel to use to exit. ESCape will return you to the menu.
  4935.  
  4936.         Run the program from the line directories when you are running
  4937.         a multiline system. Otherwise the program will give the error-
  4938.         message that the file SCONFIG.BBS is not found.
  4939.  
  4940.         13.8.2    Last callers
  4941.         --------------------------------------------------------------
  4942.  
  4943.         The second option allows you to view the last 15 callers and
  4944.         today callers of your system. The program can also give you
  4945.         some information about the BPS rates used on your BBS.
  4946.  
  4947.         13.9      BOARD2CF.EXE
  4948.         --------------------------------------------------------------
  4949.  
  4950.         This file will place the message area information contained in
  4951.         the BOARDS.BBS file, into the CONFIG.BBS file, so programs not
  4952.         able to use the BOARDS.BBS file will still be able to read the
  4953.         configuration information they need.
  4954.  
  4955.  
  4956.  
  4957.  
  4958.  
  4959.  
  4960.  
  4961.  
  4962.  
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.         --------------------------------------------------------------
  4988.         SuperBBS v1.17 Documentation                          Page 191
  4989.  
  4990.  
  4991.         Chapter 14     Useful information
  4992.         ==============================================================
  4993.  
  4994.      |  14.1      Batchfiles
  4995.      |  --------------------------------------------------------------
  4996.      |
  4997.      |  You can not run SuperBBS without a batchfile. Even when run-
  4998.      |  ning SuperBBS alone, you will need a batchfile to restart
  4999.      |  SuperBBS after a caller has logged off.
  5000.      |
  5001.      |  Thanks to Bob Jackson, ETC MedNet in San Antonio, Texas, USA,
  5002.      |  I have received some example of batchfiles to run SuperBBS.
  5003.      |  The first examples are on running SuperBBS as a stand alone
  5004.      |  system, the second with SuperBBS and Frontdoor, both examples
  5005.      |  from Len Morgan, QST BBS, USA, and a third example from Bob
  5006.      |  Jackson on how to run D'Bridge with SuperBBS. Thanks Bob!
  5007.      |
  5008.      |  IMPORTANT:  You MUST have some thing set in you autoexec.bat
  5009.      |  for batch files and SuperBBS to work properly. In your
  5010.      |  autoexec.bat file you must have set the environment variable:
  5011.      |
  5012.      |       sbbs=<drive><path>
  5013.      |
  5014.      |  This allows SuperBBS to find it's files like sbbsuser.exe,
  5015.      |  usersort.exe, etc..
  5016.      |
  5017.      |  You must also have comspec set to cause the computer to
  5018.      |  execute certain dos commands and read batch files. This is too
  5019.      |  lengthly to explain here, you should read your dos manual on
  5020.      |  Compsec. Simply put, it allows your computer to read batch
  5021.      |  files and do certain dos commands. In the autoexec.bat file
  5022.      |  this should read, set comspec=<drive><path to command.com>.
  5023.      |  You can check if compsec is set by typing SET at the DOS
  5024.      |  prompt.
  5025.      |
  5026.      |  If you don't load your bbs with a batch file, several things
  5027.      |  will happen. First, when your users exit, it will drop to dos
  5028.      |  and die. Secondly, you will not be able to ESC from the call
  5029.      |  waiting menu to drop to dos and unload your bbs program.
  5030.      |
  5031.      |  Here is a simple batch file to load your bbs when you don't
  5032.      |  use a Front End Mailer, typically Frontdoor or D'Bridge:
  5033.      |
  5034.      |  @Echo off
  5035.      |
  5036.      |  :Start
  5037.      |  bbs.exe -P1 -E0
  5038.      |
  5039.      |  :Afterbbs
  5040.      |  if errorlevel 2 goto end
  5041.      |  goto start
  5042.      |
  5043.  
  5044.  
  5045.         --------------------------------------------------------------
  5046.         SuperBBS v1.17 Documentation                          Page 192
  5047.  
  5048.  
  5049.      |  :End
  5050.      |  Echo SuperBBS is down........
  5051.      |  @Echo off
  5052.      |
  5053.      |  :Start
  5054.      |  bbs.exe -P1 -E0
  5055.      |
  5056.      |  :Afterbbs
  5057.      |  if errorlevel 2 goto end
  5058.      |  goto start
  5059.      |
  5060.      |  :End
  5061.      |  Echo SuperBBS is down........
  5062.      |
  5063.      |  Explanation of some of the points in this batchfile:
  5064.      |
  5065.      |  Line 1..: Turn off the echo so the computer doesn't show every
  5066.      |            command in the batch file.
  5067.      |
  5068.      |  Line 2..: This is called a "Label" and it MUST begin with a
  5069.      |            Colon (:) to cause the computer to recognize it, not
  5070.      |            as a command, but rather a beginning point to
  5071.      |            execute other commands below it.
  5072.      |
  5073.      |  Line 3..: Loads Superbbs. You must have this batch file in the
  5074.      |            same directory as the bbs program, otherwise you
  5075.      |            will need to CD\ before loading the bbs program.
  5076.      |            The -P tells SuperBBS what port you are using and
  5077.      |            the -E tells it to exit with an errorlevel of 0 if
  5078.      |            all goes well. The -E0 can be userful to send the
  5079.      |            computer to another label to do such things as
  5080.      |            update the Best uploader, downloader file and
  5081.      |            then send it back to start after that is done.
  5082.      |
  5083.      |  Line 4..: Anoter Label to load errorlevels.
  5084.      |
  5085.      |  Line 5..: When you either exit SuperBBS or use the ESC key in
  5086.      |            local mode, SuperBBS will exit with an errorlevel
  5087.      |            that is built into the bbs. There are 5 errorlevels
  5088.      |            that it exits with and these MUST be reserved for
  5089.      |            SuperBBS to use, so don't make an errorlevel below
  5090.      |            10. The explainations of errorlevels that SuperBBS
  5091.      |            produces, is in this documentation. In this case
  5092.      |            errorlevel 2 indicates that the sysop pressed the
  5093.      |            ESC key. The errorlevel of 2 is invisibly transmit-
  5094.      |            ted by SuperBBS and the "if errorlevel" looks to see
  5095.      |            if it matches the number and if so, it will execute
  5096.      |            the "goto" statment sending it to the designated
  5097.      |            label to execute the very next command line in that
  5098.      |            label  In this case if I pressed ESC, Sbbs produces
  5099.      |            an errorlevel of 2 and the "if errorlevel 2" sees
  5100.  
  5101.  
  5102.                                                          > Continued >
  5103.         --------------------------------------------------------------
  5104.         SuperBBS v1.17 Documentation                          Page 193
  5105.  
  5106.  
  5107.      |            that it matches. It then exucutes the goto end and
  5108.      |            sends it to the :End label, where it finds the
  5109.      |            statement Echo, which causes it to display the very
  5110.      |            next string of letters to the local screen (SuperBBS
  5111.      |            is down....).
  5112.      |
  5113.      |  Line 6..: If SuperBBS doesn't emit an errorlevel that is in
  5114.      |            the "if errorlevel" command, it will completely
  5115.      |            disregard the commands in the lines until it finds
  5116.      |            another goto or executable statment. In this case,
  5117.      |            if a user exits your bbs, it will exit with an er-
  5118.      |            rorlevel of 0, meaning all went well. Since the
  5119.      |            errorlevel of 0 isn't in the "if errorlevel" state-
  5120.      |            ments it will drop down until it sees the "goto
  5121.      |            start" statment and execute it. This will send it
  5122.      |            back up the the label of Start, which will reload
  5123.      |            the bbs for the next caller.
  5124.      |
  5125.      |  That's it. Now you will be able to run SuperBBS in a simple
  5126.      |  way. When you understand this, it is time to go a step further
  5127.      |  and add a door (= external program) to SuperBBS.
  5128.      |
  5129.      |  Now that you understand how a batch file works, now lets
  5130.      |  expand on the above batch file and add a door. First you need
  5131.      |  to understand that SuperBBS uses two ways to execute a door (a
  5132.      |  program executed outside of SuperBBS). When you set up your
  5133.      |  door from inside SuperBBS, you have two ways to call it up.
  5134.      |  You can go into the SBBS Configuration file and go to "Doors".
  5135.      |  This area is set up for programs that you want to appear in a
  5136.      |  list of your doors from the built in screen of Sbbs.
  5137.      |
  5138.      |  Many programs load with only the path and name of the program,
  5139.      |  while others require secondary programs that need to be loaded
  5140.      |  before the program, such as carrier detect and fossil pro-
  5141.      |  grams. These programs can be loaded from the "door" command
  5142.      |  line of the SuperBBS configuration file, by simply executing
  5143.      |  them like this, assuming they are in the Sbbs directory:
  5144.      |
  5145.      |       Nodedoor.exe
  5146.      |
  5147.      |  Otherwise you will have to put a path statment in front of it
  5148.      |  to locate the file, like this:
  5149.      |
  5150.      |       c:\door\nodedoor\nodedoor.exe.
  5151.      |
  5152.      |  You can use the "door" line to load batch files that require
  5153.      |  more than just a simple command line to run them. You must
  5154.      |  tell dos that you want to execute the command.com and what
  5155.      |  path to find it. This is done with the *C /c commands. The *C
  5156.      |  tells the computer where to find the command.com file, which
  5157.      |  you specified in the set comspec=c:\command.com from your
  5158.      |  autoexec.bat file. The /c tells it to execute a batch file.
  5159.  
  5160.  
  5161.         --------------------------------------------------------------
  5162.         SuperBBS v1.17 Documentation                          Page 194
  5163.  
  5164.  
  5165.      |  Your line should look like this:
  5166.      |
  5167.      |       *C /c myfile.bat
  5168.      |
  5169.      |  It can then have something called switches. You will find
  5170.      |  these elsewhere in this SuperBBS document, however, a quick
  5171.      |  overview of some of them are:
  5172.      |
  5173.      |       *F = First Name
  5174.      |       *L = Last Name
  5175.      |       *B = Baud rate
  5176.      |       *G = If user is using graphics
  5177.      |       *T = Time user has left on the bbs
  5178.      |       *S = Swap Sbbs to disk first.
  5179.      |
  5180.      |  The above batch load command should look like this:
  5181.      |
  5182.      |       *C /c myfile.bat *F *L *B *G *T *S.
  5183.      |
  5184.      |  These "switches" cause the dorinfo1.def to contain the infor-
  5185.      |  mation you specify with the * switches. Many pieces of infor-
  5186.      |  mation in the dorinfo1.def is automatic, this just assures
  5187.      |  that the basic information gets passed to the dorinfo1.def
  5188.      |  file.
  5189.      |
  5190.      |  The second use of SuperBBS is more complex and requires you to
  5191.      |  load the door from the menu you have made.  These are called a
  5192.      |  type 7 or 15 commands. A type 7 will load just like a type 15,
  5193.      |  however, it will not swap SuperBBS to dos to make room for the
  5194.      |  program, unless you use the *S switch.  More on this later.
  5195.      |  The type 15 command will swap to disk and is more usefull to
  5196.      |  save valuable memory.
  5197.      |
  5198.      |  The type 7 command is defined on the "TYPE" command line of
  5199.      |  your menu and the paramaters to load the program or bat file
  5200.      |  are put on the DATA line of the menu.
  5201.      |
  5202.      |  If I want to load a type 7 to load a batch file called
  5203.      |  myfile.bat, I would put:
  5204.      |
  5205.      |       *C /c myfile.bat *F *L *B *G *T *S
  5206.      |
  5207.      |  in the DATA field of my menu and 7 in the TYPE field.  Notice
  5208.      |  I didn't use a path statment in front of the myfile.bat, this
  5209.      |  means the program will be found in the SBBS directory, other-
  5210.      |  wise, I would have to put a path in like this:
  5211.      |
  5212.      |       *C /c c:\door\myfile\myfile.bat *F *L *B *G *T *S.
  5213.      |
  5214.      |  The only problem with this is if the program doesn't have a
  5215.      |  configuration file to specify where to find the dorinfo1.def
  5216.      |  or a path after executing it (myfile.exe c:\sbbs\dorinfo1.def)
  5217.      |  then I would have to enclude a copy command in the batch file
  5218.  
  5219.         --------------------------------------------------------------
  5220.         SuperBBS v1.17 Documentation                          Page 195
  5221.  
  5222.  
  5223.      |  to copy the dorinfo1.def to the directory of the door. Here is
  5224.      |  a sample type 7 batch file to load a carrier detect program,
  5225.      |  copy the dorinfo1.def, the program, then exit back to Sbbs:
  5226.      |
  5227.      |  Echo off
  5228.      |  cd\door\myfile
  5229.      |  watchcd on
  5230.      |  copy c:\sbbs\dorinfo1.def
  5231.      |  myfile.exe
  5232.      |  watchcd off
  5233.      |  cd\sbbs
  5234.      |  exit
  5235.      |
  5236.      |  When you use a type 15, to save memory, it will be different,
  5237.      |  becasue it uses an errorlevel to exit the bbs.
  5238.      |
  5239.      |  In the Menu DATA field you would assign a number to use for
  5240.      |  loading the program. Let us pick 100 as the number. In the
  5241.      |  TYPE field you would use 15 to indicate that this is an error-
  5242.      |  level exit.
  5243.      |
  5244.      |  Now the program will return back to your batch file that
  5245.      |  loaded the bbs to execute the errorlevel 100. Here is the look
  5246.      |  of the batch file with this new errorlevel:
  5247.      |
  5248.      |  @Echo off
  5249.      |
  5250.      |  :Start
  5251.      |  bbs -P1 -E0
  5252.      |  goto afterbbs
  5253.      |
  5254.      |  :Restart
  5255.      |  cd\sbbs
  5256.      |  bbs -R -P1 -E0
  5257.      |
  5258.      |  :Afterbbs
  5259.      |  if errorlevel 100 goto myfile
  5260.      |  if errorlevel 2 goto end
  5261.      |  goto start
  5262.      |
  5263.      |  :Myfile
  5264.      |  cd\door\myfile
  5265.      |  watchcd on
  5266.      |  copy c:\sbbs\dorinfo1.def
  5267.      |  myfile.exe
  5268.      |  watchcd off
  5269.      |  cd\sbbs
  5270.      |  goto restart
  5271.      |
  5272.      |  :End
  5273.      |  Echo SuperBBS is down........
  5274.      |
  5275.  
  5276.  
  5277.         --------------------------------------------------------------
  5278.         SuperBBS v1.17 Documentation                          Page 196
  5279.  
  5280.  
  5281.      |  You will now notice some new parts to the old batch file.
  5282.      |  These areas had to be added: The label Restart, goto restart,
  5283.      |  and the use of the -R switch after reloading bbs.exe.
  5284.      |
  5285.      |  Here is what happens how. You load the batch file and bbs.exe
  5286.      |  loads and the program waits for a call. A call comes in and
  5287.      |  the user logs on. They then execute the key for the type 15
  5288.      |  command to load myfile.exe with an errorlevel of 100. The
  5289.      |  computer leaves bbs.exe, goes to :Afterbbs and looks for the
  5290.      |  errorlevel of 100. It follows the directions and goes to
  5291.      |  :Myfile and loads the subsequent lines in that label. The user
  5292.      |  exits the myfile.exe program and the computer continues to
  5293.      |  follow the batch file until it sees "goto restart". This sends
  5294.      |  it back to the second bbs.exe with the -R for restarting the
  5295.      |  bbs. The bbs then loads again and returns the user to where
  5296.      |  they were when they pressed the key to load myfile.exe. The
  5297.      |  user logs off and SuperBBS exits with an errorlevel of 0 as
  5298.      |  indicated by the -E0. The next line in :Restart, after un-
  5299.      |  loading the bbs.exe -R, doesn't have a "goto" line, so it
  5300.      |  drops directly into the next label (:Afterbbs), looks for
  5301.      |  errorlevel of 0 and not finding it goes to the line "goto
  5302.      |  start", then executes it and reloads the bbs.
  5303.      |
  5304.      |  You can now add as many errorlevels as you want with a type
  5305.      |  15.  When you learn enough to run a FIDO mail board, you will
  5306.      |  use other preset errorlevels like 3,4 and 5.  These will tell
  5307.      |  Superbbs that you entered Netmail (3), Echomail (4), or both
  5308.      |  Echomail and Netmail (5). You will then have to learn how to
  5309.      |  use external programs to process the messages left with these
  5310.      |  levels.
  5311.      |
  5312.      |  Now for the examples on running SuperBBS with a mailer pro-
  5313.      |  gram. First an example on Frontdoor and SuperBBS. Again by
  5314.      |  Len Morgan, just as the example above.
  5315.      |
  5316.      |  There are two ways of loading SuperBBS, when a Mailer is being
  5317.      |  used to answer the phone. In this file, we will discuss the
  5318.      |  EXITING method of loading your bbs. The advantage of using the
  5319.      |  EXIT method of loading, is that it uses less memory to run the
  5320.      |  bbs and other programs, however, this method runs slower than
  5321.      |  the second method called SPAWNING (See Spawnbat.txt).
  5322.      |
  5323.      |  I will assume that you understand batch file language and
  5324.      |  commands.
  5325.      |
  5326.      |  With the many different mailer programs such as Frontdoor,
  5327.      |  D'Bridge, Bindkley, etc., I cannot tell you how to cause your
  5328.      |  mailer to exit with a method of passing certain parameters to
  5329.      |  SuperBBS, however, I do know that Frontdoor uses errorlevels
  5330.      |  for the baud rates from inside it's setup, as an example, 300
  5331.      |  baud is errorlevel 255, 1200 baud is 254, etc..
  5332.      |
  5333.  
  5334.  
  5335.         --------------------------------------------------------------
  5336.         SuperBBS v1.17 Documentation                          Page 197
  5337.  
  5338.  
  5339.      |  With D'bridge, the baud rate is passed to the bbs program by a
  5340.      |  simple formula of, baud rate divided by 10 = errorlevel. So
  5341.      |  2400 / 10 = 24.  In this case the errorlevel 24 means 2400
  5342.      |  baud.
  5343.      |
  5344.      |  When SuperBBS is loaded you can use the "if errorlevel" to
  5345.      |  find the baud rate. For example when using Frontdoor, if
  5346.      |  errorlevel 253 goto 2400, would cause the batch file to see if
  5347.      |  the errorlevel of the caller was 2400 baud and if so, pass the
  5348.      |  caller to the 2400 label and load the bbs, simularly, if
  5349.      |  D'Bridge is used, then the "if errorlevel 24 go to 2400",
  5350.      |  label would work.
  5351.      |
  5352.      |  We will have a look at the example of the NNN SuperBBS batch-
  5353.      |  file. Here's the batchfile, afterwards Len will add some of
  5354.      |  his comments to it:
  5355.  
  5356.         First the CD-Rom is tested. This makes sure the CD-Rom will be
  5357.         available when called upon from SuperBBS. Then Frontdoor is
  5358.         started. Depending on the errorlevel of the exit from Front-
  5359.         door, will the BBS be started or an event will be executed.
  5360.         Errorlevels 117 to 124 represent the different modemspeeds.
  5361.         These errorlevels are set in the configuration program of
  5362.         Frontdoor. Errorlevel 116 is a local logon, executed through
  5363.         the use of a function key in Frontdoor.
  5364.  
  5365.         Errorlevel 110 is executed when it is time for the event,
  5366.         mostly run in the early hours of the day. Errorlevel 125 is
  5367.         used when mail is received by Frontdoor. The system is using
  5368.         two different limits.ctl files, one for the hours between
  5369.         18:00 and 24:00 hours and one for the other time period. They
  5370.         are copied at two events in Frontdoor, errorlevel 105 and 104.
  5371.  
  5372.         The second part in this batchfile with errorlevels is the part
  5373.         where SuperBBS will exit to after a type 15 exit and after the
  5374.         user logged off. Depending on the errorlevel a certain action
  5375.         is taken. If the user logged of, Frontdoor will be started
  5376.         again. If it was a type 15 exit, an external program is
  5377.         started. After the external program SuperBBS will restart with
  5378.         the -R option and again return to the errorlevel part when the
  5379.         user logged off, or used another type 15 exit.
  5380.  
  5381.         rem Batchfile NNN SuperBBS - may 1991
  5382.         rem Last revised:  12-06-91
  5383.  
  5384.         @echo off
  5385.         :cdrom
  5386.         dir d:\
  5387.  
  5388.         :start
  5389.         cd\fd
  5390.         fd.exe
  5391.  
  5392.  
  5393.         --------------------------------------------------------------
  5394.         SuperBBS v1.17 Documentation                          Page 198
  5395.  
  5396.  
  5397.         if errorlevel 125 goto mail
  5398.         if errorlevel 124 goto 38400bps
  5399.         if errorlevel 123 goto 19200bps
  5400.         if errorlevel 122 goto 16800bps
  5401.         if errorlevel 121 goto 14400bps
  5402.         if errorlevel 120 goto 12000bps
  5403.         if errorlevel 119 goto 9600bps
  5404.         if errorlevel 118 goto 4800bps
  5405.         if errorlevel 117 goto 2400bps
  5406.         if errorlevel 116 goto 1200bps
  5407.         if errorlevel 115 goto local
  5408.         if errorlevel 110 goto maint
  5409.         if errorlevel 105 goto avond
  5410.         if errorlevel 104 goto dag
  5411.         if errorlevel  10 goto end
  5412.         if errorlevel   1 goto error
  5413.         goto end
  5414.  
  5415.         :38400bps
  5416.         cd\superbbs\line1
  5417.         bbs -N1 -B38400
  5418.         goto afterbbs
  5419.  
  5420.         :19200bps
  5421.         cd\superbbs\line1
  5422.         bbs -N1 -B19200
  5423.         goto afterbbs
  5424.  
  5425.         :16800bps
  5426.         cd\superbbs\line1
  5427.         bbs -N1 -B16800
  5428.         goto afterbbs
  5429.  
  5430.         :14400bps
  5431.         cd\superbbs\line1
  5432.         bbs -N1 -B14400
  5433.         goto afterbbs
  5434.  
  5435.         :12000bps
  5436.         cd\superbbs\line1
  5437.         bbs -N1 -B12000
  5438.         goto afterbbs
  5439.  
  5440.         :9600bps
  5441.         cd\bbs\line1
  5442.         bbs -N1 -B9600
  5443.         goto afterbbs
  5444.  
  5445.         :7200bps
  5446.         cd\bbs\line1
  5447.         bbs -N1 -B7200
  5448.         goto afterbbs
  5449.  
  5450.  
  5451.         --------------------------------------------------------------
  5452.         SuperBBS v1.17 Documentation                          Page 199
  5453.  
  5454.  
  5455.         :4800bps
  5456.         cd\bbs\line1
  5457.         bbs -N1 -B4800
  5458.         goto afterbbs
  5459.  
  5460.         :2400bps
  5461.         cd\bbs\line1
  5462.         bbs -N1 -B2400
  5463.         goto afterbbs
  5464.  
  5465.         :1200bps
  5466.         cd\bbs\line1
  5467.         bbs -N1 -B1200
  5468.         goto afterbbs
  5469.  
  5470.         :local
  5471.         cd\bbs\line1
  5472.         bbs -l -N1
  5473.         goto afterbbs
  5474.  
  5475.         :mail
  5476.         echo ath1 > com2
  5477.         gecho toss
  5478.         mbutil link
  5479.         goto start
  5480.  
  5481.         :dag
  5482.         cd \superbbs
  5483.         copy tijd1.bbs limits.bbs
  5484.         goto start
  5485.  
  5486.         :avond
  5487.         cd \superbbs
  5488.         copy tijd2.bbs limits.bbs
  5489.         goto start
  5490.  
  5491.         :maint
  5492.         echo ath1 > com2
  5493.         cd\superbbs
  5494.         copy users.bbs users.fh
  5495.         copy susers.bbs susers.fh
  5496.         mbutil purge -file mbutil.bbs
  5497.         mbutil index -renumber -delete
  5498.         mbutil pack -renumber -overwrite
  5499.         mbutil link
  5500.         userpack -D90 -S5
  5501.         fast /s
  5502.         maf
  5503.         copy \superbbs\line1\config.bbs \superbbs\config.bbs
  5504.         dbest c:\superbbs\text\top-uplf NNN_SuperBBS 200 u25
  5505.         dbest c:\superbbs\text\top-dowf NNN_SuperBBS 200 d25
  5506.         dbest c:\superbbs\text\top-uplk NNN_SuperBBS 200 r25
  5507.         dbest c:\superbbs\text\top-dowk NNN_SuperBBS 200 s25
  5508.  
  5509.         --------------------------------------------------------------
  5510.         SuperBBS v1.17 Documentation                          Page 200
  5511.  
  5512.  
  5513.         dbest c:\superbbs\text\top-call NNN_SuperBBS 200 c25
  5514.         dbest c:\superbbs\text\top-mess NNN_SuperBBS 200 m25
  5515.         dbest c:\superbbs\text\top-area NNN_SuperBBS 200 b25
  5516.         dbest c:\superbbs\text\top-syst NNN_SuperBBS 200 i
  5517.         delete \superbbs\config.bbs
  5518.         boot
  5519.         goto start
  5520.  
  5521.         :afterbbs
  5522.         if errorlevel 250 goto start
  5523.         if errorlevel 152 goto upload
  5524.         if errorlevel 151 goto download
  5525.         if errorlevel 150 goto xpress
  5526.         if errorlevel   5 goto both
  5527.         if errorlevel   4 goto echomail
  5528.         if errorlevel   3 goto netmail
  5529.         if errorlevel   1 goto end
  5530.         goto start
  5531.  
  5532.         :restartbbs
  5533.         cd\superbbs\line1
  5534.         bbs -R -N1
  5535.         goto afterbbs
  5536.  
  5537.         :both
  5538.         echo ath1 > com2
  5539.         gecho scan pack
  5540.         goto start
  5541.  
  5542.         :echomail
  5543.         echo ath1 > com2
  5544.         gecho scan pack
  5545.         goto start
  5546.  
  5547.         :netmail
  5548.         echo ath1 > com2
  5549.         gecho scan pack
  5550.         goto start
  5551.  
  5552.         :xpress
  5553.         cd\xpress
  5554.         xpmail -P2 -F -B38400 -DISF -NC
  5555.         goto restartbbs
  5556.  
  5557.         :upload
  5558.         cd\xpress
  5559.         xpmail -P2 -F -B38400 -DISF -NC -U
  5560.         goto restartbbs
  5561.  
  5562.         :download
  5563.         cd\xpress
  5564.         xpmail -P2 -F -B38400 -DISF -NC -DAP
  5565.         goto restartbbs
  5566.  
  5567.         --------------------------------------------------------------
  5568.         SuperBBS v1.17 Documentation                          Page 201
  5569.  
  5570.  
  5571.         :error
  5572.         echo Systeem error !!
  5573.  
  5574.         :end
  5575.         echo ath1 > com2
  5576.         echo NNN SuperBBS down.
  5577.  
  5578.      |  That's the batchfile, now for an explanation on some of the
  5579.      |  parts....
  5580.      |
  5581.      |  @Echo off:
  5582.      |
  5583.      |  In this example the first line turns off the echo so the
  5584.      |  commands don't appear on the screen. The @ only works in DOS
  5585.      |  3.3 and hiogher and prevents the line Echo off to be dis-
  5586.      |  played. If you use a DOS version before 3.3 upgrade now or
  5587.      |  leave the @ off.
  5588.      |
  5589.      |  :cdrom
  5590.      |  dir d:\
  5591.      |
  5592.      |  This line is used if you have a cd\rom for storing overlays or
  5593.      |  files on. It makes sure the CD-Rom is available to SuperBBS.
  5594.      |  Microsoft recommends to do a DIR command to the CD-Rom player
  5595.      |  before starting a program which uses the CD-Rom player. It is
  5596.      |  normally not used.
  5597.      |
  5598.      |  :start
  5599.      |  cd\fd
  5600.      |  fd.exe
  5601.      |
  5602.      |  This loads the Frontdoor mailer.
  5603.      |
  5604.      |  "if errorlevel 125 goto mail"
  5605.      |
  5606.      |  This begins the process of trapping the errorlevel created by
  5607.      |  the Mailer. In this case, the first errorlevel of 125, is
  5608.      |  looking to see if mail came in, and if so, it executes a mail
  5609.      |  tosser program.
  5610.      |
  5611.      |  Finally, we come to the errorlevel of 124, which would trap a
  5612.      |  users baud rate of 38400. It would then look for the goto
  5613.      |  statement and execute it. In this case it is "goto 38400bps",
  5614.      |  which is the name of the label it goes to.
  5615.      |
  5616.      |  Follow down the batch file until you find :38400bps, you will
  5617.      |  see that this label loads the bbs with a -N1 -B38400. The N1,
  5618.      |  is telling Superbbs that it is operating on line 1, of a
  5619.      |  multiline system. If you don't run a multiline system then you
  5620.      |  don't need to change directories to cd\superbbs\line1. Instead
  5621.      |  you would cd\sbbs and then load bbs.exe like this:
  5622.      |
  5623.  
  5624.  
  5625.         --------------------------------------------------------------
  5626.         SuperBBS v1.17 Documentation                          Page 202
  5627.  
  5628.  
  5629.      |  :38400bps
  5630.      |  cd\superbbs
  5631.      |  bbs -B38400 -E0
  5632.      |  goto afterbbs
  5633.      |
  5634.      |  In this case, I added the -E0 to tell Superbbs to exit with an
  5635.      |  errorlevel of 0, if all goes well. The "if errorlevel 0" can
  5636.      |  be used to run another program before it reloads the bbs. The
  5637.      |  "goto afterbbs", at the end of the :38400bps label, is sending
  5638.      |  it to another errorlevel checker, that traps errorlevels of
  5639.      |  SuperBBS, look for :Afterbbs. Unlike the errorlevels created
  5640.      |  by the mailer, these new errorlevels work on errorlevels
  5641.      |  passed from SuperBBS, when it exits from the bbs to load
  5642.      |  files.
  5643.      |
  5644.      |  :Afterbbs
  5645.      |
  5646.      |  When the user exits SuperBBS, a new errorlevel is created and
  5647.      |  the :Afterbbs label is loaded. The trap looks for any of the
  5648.      |  errorlevels created by Sbbs, if found causes the computer to
  5649.      |  follow the goto statment to the label indicated.
  5650.      |
  5651.      |  In the label :Afterbbs, you will see errorlevel 250.  This
  5652.      |  errorlevel sends the computer right back to the :start and
  5653.      |  reloads the mailer of fd.exe.  In errorlevel 1 the label says,
  5654.      |  goto end.  Follow this to the label :End, you will see echo
  5655.      |  ath1 > com2 then echo NNN SuperBBS down....
  5656.      |
  5657.      |  This label causes the comport 2 to take the phone off the hook
  5658.      |  and echo the string Node 2 SuperBBS down.... to the screen.
  5659.      |  This means that something went wrong and SuperBBS gave the
  5660.      |  errorlevel of 1 to the batchfile.  Remember, errorlevel 0,
  5661.      |  means that all went well, so errorlevel of 1 means that there
  5662.      |  was a failure somewhere in the execution of Sbbs.  The 1 got
  5663.      |  trapped in the "if errorlevel statment" and it followed the
  5664.      |  direction to goto label End.
  5665.      |
  5666.      |  Don't be alarmed if you don't see the if errorlevel 0, in the
  5667.      |  batch file. It is usually understood that if all the errorle-
  5668.      |  vels that Superbbs defaults to when in trouble or processing
  5669.      |  mail (errorlevels 1-5) don't match, then 0 is assumed and it
  5670.      |  passes to the last line in the :Afterbbs trap to the "goto
  5671.      |  start", which sends it right back up top and loads the mailer
  5672.      |  again.
  5673.      |
  5674.      |  If you add the -P*P or -T*T switch to load Superbbs, it will
  5675.      |  look for the Port and Time to the next event that can be
  5676.      |  passed by your mailer. This way, you can specify different
  5677.      |  ports and the remaining time, so a user dosen't over stay his
  5678.      |  time and the mailer can execute a scheduled event like a
  5679.      |  routine to clean the bbs at midnight. This way, you won't have
  5680.      |  to activate the EVENTS in superBBS to kick off the user. I
  5681.  
  5682.  
  5683.         --------------------------------------------------------------
  5684.         SuperBBS v1.17 Documentation                          Page 203
  5685.  
  5686.  
  5687.      |  recommend that you activate them anyway as a security in case
  5688.      |  the mailer and SuperBBS are not passing the time and port. I
  5689.      |  have seen mailers fail to pass the time and allow users online
  5690.      |  past midnight.  This causes SuperBBS to leave that user with
  5691.      |  time left from the previous day, instead of resetting them to
  5692.      |  a new time limit for a new day. The *P and *T simply passes
  5693.      |  the port and time from the mailer which should be hidden and
  5694.      |  can be trapped with the *P and *T switches.
  5695.      |
  5696.      |  To add an errorlevel to the batch file for loading a door,
  5697.      |  only requires you to add it to the right trap. Remember there
  5698.      |  are two errorlevel traps. One for the mailer and the other for
  5699.      |  the bbs. Add the door to the :Afterbbs trap sending it to a
  5700.      |  new label. Remember also, when the label has been run, you
  5701.      |  must either reload the bbs or restart the mailer. On a game
  5702.      |  door, you will want to send the user back to the bbs. To do
  5703.      |  this you will need a label of :restartbbs, or such simular
  5704.      |  name.
  5705.      |
  5706.      |  Look at the :Afterbbs trap and you will see errorlevel 150.
  5707.      |  This sends the bbs to xpress. :Xpress will load an outside
  5708.      |  program (xpmail) and when done, it allows the computer to drop
  5709.      |  into the goto restartbbs line. This line loads the label
  5710.      |  :restartbbs, which in turn loads the bbs with a -R switch.
  5711.      |  This tells Superbbs that this isn't the first time the bbs was
  5712.      |  loaded and to restart the bbs.
  5713.      |
  5714.      |  I hope you are beginning to catch on now.
  5715.      |
  5716.      |  This is to show you how to use the SPAWNING method of making a
  5717.      |  batch file.
  5718.      |
  5719.      |  SPAWNING method requires more memory, however, it operates
  5720.      |  much faster and once you get the hang of it, you won't have a
  5721.      |  problem. Even though it takes more memory, I have used it
  5722.      |  without any problems on a 640k RAM systems for years.
  5723.      |
  5724.      |
  5725.      |  What is spawning? If you think of two fish, who find each
  5726.      |  other, spawn and make an off spring, then you will understand
  5727.      |  the spawn method. One batch file spawns a second batch file,
  5728.      |  that will load the third batch file.
  5729.      |
  5730.      |  If you run Frontdoor, in the configuration program you find an
  5731.      |  option about creating a batch file. You will need to answer
  5732.      |  YES to this question as well as assign an errorlevel to be
  5733.      |  trapped. Let's use errorlevel 200. You will also have to give
  5734.      |  a name of the file that the spawn will load. In this case, we
  5735.      |  are going to call it EXEBBS.BAT and you will have to find
  5736.      |  where in Frontdoor to give it the name of this file. It has
  5737.      |  been too long since I have run Frontdoor.
  5738.      |
  5739.  
  5740.  
  5741.         --------------------------------------------------------------
  5742.         SuperBBS v1.17 Documentation                          Page 204
  5743.  
  5744.  
  5745.      |  In this second batch file called DOBBS or SBBS, includes four
  5746.      |  paramaters:
  5747.      |
  5748.      |       1) The name of the third batch file to be loaded.
  5749.      |       2) The baud rate.
  5750.      |       3) The port being used.
  5751.      |       4) The time to next event.
  5752.      |
  5753.      |       Note that Frontdoor 2.01 has a problem with the event
  5754.      |       time on some BPS rates. Use 2.02 instead.
  5755.      |
  5756.      |  All this will be waiting to be trapped by the third batch file
  5757.      |  that loads your bbs called EXEBBS.BAT. When using Frontdoor
  5758.      |  this DOBBS.BAT file is automatically made and named dobbs.bat,
  5759.      |  as long as you have the "Create batch" on in the FD config.
  5760.      |
  5761.      |  For simplicity sake, we will call the first batch file, that
  5762.      |  loads your Frontdoor or D'Bridge Mailer, RUNFD.BAT.  This file
  5763.      |  loads the bbs and can look something like this:
  5764.      |
  5765.      |  @echo off
  5766.      |  :start
  5767.      |  d:
  5768.      |  cd \fd
  5769.      |  fd
  5770.      |  if errorlevel 200 goto loadbbs
  5771.      |  if errorlevel 189 goto clean
  5772.      |  if errorlevel 188 goto normal_routing
  5773.      |  goto end
  5774.      |
  5775.      |  :loadbbs
  5776.      |  sbbs.bat
  5777.      |
  5778.      |  :clean
  5779.      |  cd\sbbs
  5780.      |  mbutil purge -file mbutil.pur
  5781.      |  mbutil pack -force -delete -recover
  5782.      |  mbutil sort -pack
  5783.      |  mbutil link
  5784.      |  goto start
  5785.      |
  5786.      |  :normal_routing
  5787.      |  cd\sbbs
  5788.      |  stop d:\sbbs\txtfiles\best u10 d10 c10 m10 b10
  5789.      |  userpack -d60
  5790.      |  usersort sec- last+ first+
  5791.      |  goto start
  5792.      |
  5793.      |  :end
  5794.      |  Echo Frontdoor is down....
  5795.      |
  5796.  
  5797.  
  5798.  
  5799.         --------------------------------------------------------------
  5800.         SuperBBS v1.17 Documentation                          Page 205
  5801.  
  5802.  
  5803.      |  When the Mailer exited, it created a batch file called
  5804.      |  DOBBS.BAT for Frontdoor. The mailer then exits with an error-
  5805.      |  level of 200 and is trapped by the "if errorlevel 200 goto
  5806.      |  loadbbs" line of the trap.  The batch file sees the 200,
  5807.      |  executes and drops to a label called :loadbbs. It then
  5808.      |  executes the "spawned" batch file called either dobbs.bat or
  5809.      |  sbbs.bat.
  5810.      |
  5811.      |  Below is the EXEBBS.BAT file that loads your bbs:
  5812.      |
  5813.      |  rem exebbs.bat to load the bbs
  5814.      |  echo off
  5815.      |  if %1==local goto local_sbbs
  5816.      |  cd\sbbs
  5817.      |  bbs -B%1 -P%2 -T%3 -E0
  5818.      |  goto after_sbbs
  5819.      |
  5820.      |  :restart_sbbs
  5821.      |  cd\sbbs
  5822.      |  bbs -R -E0
  5823.      |  goto after_sbbs
  5824.      |
  5825.      |  :after_sbbs
  5826.      |  if errorlevel 60 goto ava
  5827.      |  if errorlevel 5 goto finish
  5828.      |  if errorlevel 4 goto finish
  5829.      |  if errorlevel 3 goto netmail
  5830.      |  if errorlevel 2 goto finish
  5831.      |  if errorlevel 1 goto end
  5832.      |  if errorlevel 0 goto finish
  5833.      |  goto out
  5834.      |
  5835.      |  :netmail
  5836.      |  cd\sbbs
  5837.      |  mbutil export snetmail d:\db\mail
  5838.      |  cd\sbbs
  5839.      |  goto finish
  5840.      |
  5841.      |  :ava
  5842.      |  d:
  5843.      |  cd\ava
  5844.      |  ava ava.cfg d:\sbbs\
  5845.      |  cd\sbbs
  5846.      |  goto restart_sbbs
  5847.      |
  5848.      |  :local_sbbs
  5849.      |  cd\sbbs
  5850.      |  d:\sbbs
  5851.      |  bbs -L -E0
  5852.      |  if errorlevel 3 go to netmail
  5853.      |  goto finish
  5854.      |
  5855.  
  5856.  
  5857.         --------------------------------------------------------------
  5858.         SuperBBS v1.17 Documentation                          Page 206
  5859.  
  5860.  
  5861.      |  :finish
  5862.      |  cd\fd
  5863.      |  runfd
  5864.      |
  5865.      |  :out
  5866.      |  Echo SuperBBS is down.....
  5867.      |
  5868.      |  The %1 is used to check and see if the bbs is being loaded
  5869.      |  locally. This is also a trap and it will look at the spawned
  5870.      |  batch file to see if there is a word of "local" instead of a
  5871.      |  baud rate.  If so, it goes to a local label.  If not, it drops
  5872.      |  down and loads the bbs with:
  5873.      |
  5874.      |       BBS B%1 P%2 T%3 -E0.
  5875.      |
  5876.      |  Let's refresh this procedure once more. The RUNFD.BAT loaded
  5877.      |  the mailer. A call came in and it was determined by the mailer
  5878.      |  that it was as human and spawned the file DOBBS.  The computer
  5879.      |  went to the label ":loadbbs", then dropped into the DOBBS.BAT.
  5880.      |  Inside this batch file it told the computer to load a program
  5881.      |  called EXEBBS (.bat extension assumed), and it carried the
  5882.      |  baud rate of the caller, comm port, and time remaining. Here
  5883.      |  is what the DOBBS looked like inside of it:
  5884.      |
  5885.      |       EXEBBS 14400 1 67
  5886.      |
  5887.      |  This is an actual spawned batch file called sbbs.bat from my
  5888.      |  bbs. The first word is the name of the batch file it is to
  5889.      |  load. The second is the baud rate of the caller, the next is
  5890.      |  the com port, and the last is the time this user has before
  5891.      |  the next event for the mailer.
  5892.      |
  5893.      |  The % sign after the -B,-P, and -T switches puts the numbers
  5894.      |  in for the baud rate, port and time. In the above example the
  5895.      |  -B%1 loads the first numeric value of 14400 as the baud
  5896.      |  rate, -P%2 loads the second numeric value of 1 for the port,
  5897.      |  and the -T%3 load the third numeric value of 67 for the min-
  5898.      |  utes until the next event.
  5899.      |
  5900.      |  The last line in the after loading the bbs is, goto after_sbbs
  5901.      |  which sends the bbs to the trap for any doors.
  5902.      |
  5903.      |  If you will notice in :After_sbbs, the errorlevel of 60 sends
  5904.      |  the computer to another label called :Ava, which loads my call
  5905.      |  back verifier and when done sends the user back to the bbs
  5906.      |  with the "goto restart_sbbs" by reloading the bbs with the -R
  5907.      |  switch.  This tells Sbbs that is is being reloaded and to pass
  5908.      |  the caller back to bbs without doing a complete reload.
  5909.  
  5910.  
  5911.  
  5912.  
  5913.  
  5914.  
  5915.         --------------------------------------------------------------
  5916.         SuperBBS v1.17 Documentation                          Page 207
  5917.  
  5918.  
  5919.      |  In this example, unlike my other batch files, I used the if
  5920.      |  errorlevel 0, instead of assuming it and allowing it to pass
  5921.      |  to the goto line at the end. This time I don't want it to pass
  5922.      |  to the last line (goto out), since that will send it to a
  5923.      |  label called :End, that will end the batch file and I don't
  5924.      |  want to do that.
  5925.      |
  5926.      |  The greatest difference between EXITING and SPAWNING is that,
  5927.      |  the latter method eliminates all the need for each baud rate
  5928.      |  that might come in. When you run a 2400 baud modem this isn't
  5929.      |  so significant, however, when you run 14400 baud this can
  5930.      |  present a lot of work and more of a chance of error.
  5931.      |
  5932.      |  The EXITING method only requires one batch file to do both the
  5933.      |  mailer and the bbs, whereas, the SPAWNING method requires two.
  5934.      |
  5935.      |  I much prefer the SPAWNING method and have used it successful-
  5936.      |  ly for many years now. It runs quick and makes looking at the
  5937.      |  bbs batch file easier than looking at both crammed into one.
  5938.      |  That confuses me and I can't afford that, I'm confused easily
  5939.      |  enough. :-)
  5940.      |
  5941.      |  I hope this has helped you.  If you need any assistance, let
  5942.      |  me know.
  5943.      |
  5944.      |  Information by:     Len Morgan
  5945.      |                      QST BBS
  5946.      |                      SuperBBS Western U.S. Sup./Reg./Beta Site
  5947.      |                      FidoNet: 1:203/730
  5948.      |                      (916) 920-1288
  5949.      |
  5950.      |  Here are two complete examples of the RUNFD.BAT and EXEBBS.BAT
  5951.      |  files. If you need more info, contact the Support sites.
  5952.      |
  5953.      |  -----------------------
  5954.      |   Example of RUNFD.BAT
  5955.      |  -----------------------
  5956.      |
  5957.      |  ECHO OFF
  5958.      |  :LOOP
  5959.      |  CD\FD
  5960.      |  FD.EXE
  5961.      |  IF ERRORLEVEL 255 GOTO BBS
  5962.      |  IF ERRORLEVEL 254 GOTO BBS
  5963.      |  IF ERRORLEVEL 253 GOTO BBS
  5964.      |  IF ERRORLEVEL 200 GOTO MAILIN
  5965.      |  IF ERRORLEVEL 199 GOTO LOCAL_BBS
  5966.      |  IF ERRORLEVEL 198 GOTO QD3
  5967.      |  IF ERRORLEVEL 197 GOTO BBS_CONFIG
  5968.      |  IF ERRORLEVEL 196 GOTO L_CONFIG
  5969.      |  IF ERRORLEVEL 195 GOTO Q_EDIT
  5970.      |  IF ERRORLEVEL 194 GOTO USER_EDIT
  5971.      |  IF ERRORLEVEL 193 GOTO MM
  5972.  
  5973.         --------------------------------------------------------------
  5974.         SuperBBS v1.17 Documentation                          Page 208
  5975.  
  5976.  
  5977.      |  IF ERRORLEVEL 192 GOTO FMAIL_SETUP
  5978.      |  IF ERRORLEVEL 191 GOTO FFAM
  5979.      |  IF ERRORLEVEL 190 GOTO BBSMENU
  5980.      |  IF ERRORLEVEL 165 GOTO TICK
  5981.      |  IF ERRORLEVEL 150 GOTO CLEAN_1
  5982.      |  IF ERRORLEVEL 149 GOTO CLEAN_2
  5983.      |  IF ERRORLEVEL 148 GOTO NODE
  5984.      |  IF ERRORLEVEL 147 GOTO SUTILFREQ
  5985.      |  GOTO END
  5986.      |
  5987.      |  :BBS
  5988.      |  DOBBS
  5989.      |  GOTO LOOP
  5990.      |
  5991.      |  :MAILIN
  5992.      |  CD\SBBS
  5993.      |  FMAIL TOSS
  5994.      |  GOTO LOOP
  5995.      |
  5996.      |  :LOCAL_BBS
  5997.      |  C:\COMMAND.COM /C EXEBBS.BAT LOCAL
  5998.      |  GOTO LOOP
  5999.      |
  6000.      |  :QD3
  6001.      |  QD3.EXE
  6002.      |  GOTO LOOP
  6003.      |
  6004.      |  :BBS_CONFIG
  6005.      |  CD\SBBS
  6006.      |  CONFIG.EXE
  6007.      |  GOTO LOOP
  6008.      |
  6009.      |  :L_CONFIG
  6010.      |  CD\SBBS
  6011.      |  LCONFIG.EXE
  6012.      |  GOTO LOOP
  6013.      |
  6014.      |  :Q_EDIT
  6015.      |  Q.EXE
  6016.      |  GOTO LOOP
  6017.      |
  6018.      |  :USER_EDIT
  6019.      |  CD\SBBS
  6020.      |  SBBSUSER.EXE
  6021.      |  GOTO LOOP
  6022.      |
  6023.      |  :MM
  6024.      |  CD\SBBS
  6025.      |  MM.EXE
  6026.      |  GOTO LOOP
  6027.      |
  6028.  
  6029.  
  6030.  
  6031.         --------------------------------------------------------------
  6032.         SuperBBS v1.17 Documentation                          Page 209
  6033.  
  6034.  
  6035.      |  :FMAIL_SETUP
  6036.      |  CD\SBBS
  6037.      |  FSETUP.EXE
  6038.      |  GOTO LOOP
  6039.      |
  6040.      |  :FFAM
  6041.      |  CD\SBBS
  6042.      |  FIDO-FAM FLSEARCH.CTL z l
  6043.      |  GOTO LOOP
  6044.      |
  6045.      |  :BBSMENU
  6046.      |  CD\SBBS
  6047.      |  SBBSMENU.EXE
  6048.      |  GOTO LOOP
  6049.      |
  6050.      |  :CLEAN_1
  6051.      |  CD\UTIL
  6052.      |  FILESORT.EXE
  6053.      |  RMBAK.EXE
  6054.      |  CD\SBBS\HOLIDAY
  6055.      |  HOLIBBS.EXE
  6056.      |  CD\SBBS
  6057.      |  FMAIL SCAN /S
  6058.      |  FMAIL TOSS
  6059.      |  FMAIL PACK /C /H /O
  6060.      |  FTOOLS MAINT /D /N
  6061.      |  FTOOLS MAINT /P
  6062.      |  USERPACK -D60
  6063.      |  STOP TOP10 b10 t10 c10 d10 u10 m10 i
  6064.      |  GOTO LOOP
  6065.      |
  6066.      |  :CLEAN_2
  6067.      |  CD\AVL
  6068.      |  AVAILIST.EXE
  6069.      |  CD\SBBS
  6070.      |  SUTIL DATEFILE \SBBS\SYSTEM.LOG
  6071.      |  CD\FD
  6072.      |  SUTIL DATEFILE \FD\FD.LOG
  6073.      |  GOTO LOOP
  6074.      |
  6075.      |  :NODE
  6076.      |  CD\FD\FILES
  6077.      |  IF NOT EXIST NODEDIFF.* GOTO LOOP
  6078.      |  spaz NODEDIFF.* C:\FD\NODE
  6079.      |  DEL NODEDIFF.*
  6080.      |  CD\FD\NODE
  6081.      |  XLAXDIFF.EXE
  6082.      |  FDNC /F
  6083.      |  CD\SBBS
  6084.      |  SBBSNODE.EXE
  6085.      |  GOTO LOOP
  6086.      |
  6087.  
  6088.  
  6089.         --------------------------------------------------------------
  6090.         SuperBBS v1.17 Documentation                          Page 210
  6091.  
  6092.  
  6093.      |  REM :SUTILFREQ
  6094.      |  REM CD\SBBS
  6095.      |  REM CALL MAKEFREQ.BAT
  6096.      |  REM GOTO LOOP
  6097.      |
  6098.      |  :TICK
  6099.      |  CD\FD
  6100.      |  TICK.EXE > TICK.LOG
  6101.      |  GOTO LOOP
  6102.      |
  6103.      |  :END
  6104.      |
  6105.      |
  6106.      |
  6107.      |  ------------------------
  6108.      |   Example of EXEBBS.BAT
  6109.      |  ------------------------
  6110.      |
  6111.      |  ECHO OFF
  6112.      |  CD\SBBS
  6113.      |  IF %1==LOCAL GOTO LOCAL_BBS
  6114.      |  BBS -B%1 -P%2 -T%3 -E0
  6115.      |  GOTO AFTER_BBS
  6116.      |
  6117.      |  :RESTART_BBS
  6118.      |  CD\SBBS
  6119.      |  BBS -R -E0
  6120.      |  GOTO AFTER_BBS
  6121.      |
  6122.      |  :AFTER_BBS
  6123.      |  IF ERRORLEVEL  50 GOTO OUTSIDE
  6124.      |  IF ERRORLEVEL   5 GOTO MAILOUT
  6125.      |  IF ERRORLEVEL   4 GOTO MAILOUT
  6126.      |  IF ERRORLEVEL   3 GOTO MAILOUT
  6127.      |  GOTO OUT
  6128.      |
  6129.      |  :LOCAL_BBS
  6130.      |  CD ..
  6131.      |  CD\SBBS
  6132.      |  BBS -L -E0
  6133.      |  GOTO AFTER_BBS
  6134.      |
  6135.      |  :OUTSIDE
  6136.      |  CTTY GATE1 ON
  6137.      |  COMMAND.COM
  6138.      |  CTTY CON
  6139.      |  GOTO RESTART_BBS
  6140.      |
  6141.      |  :MAILOUT
  6142.      |  CD\SBBS
  6143.      |  FMAIL SCAN /S
  6144.      |  FMAIL PACK /C /O
  6145.      |  GOTO OUT
  6146.  
  6147.         --------------------------------------------------------------
  6148.         SuperBBS v1.17 Documentation                          Page 211
  6149.  
  6150.  
  6151.      |  :OUT
  6152.      |  CD\FD
  6153.      |  RUNFD.BAT
  6154.      |
  6155.      |  Here's an example of running a system with D'Bridge as a
  6156.      |  mailer. This example is supplied by Bob Jackson, ETC MedNet.
  6157.      |  Also included are the AUTOEXEC.BAT and CONFIG.BAT files:
  6158.      |
  6159.      |   ** AUTOEXEC.BAT **
  6160.      |
  6161.      |  @ECHO OFF
  6162.      |  PROMPT $e[1;44;37m∙$e[0m$e[41m▀▀▀$e[0m $p$g
  6163.      |  PATH=C:\;C:\DOS;c:\stacker;C:\TOOLS;C:\TOOLS\BIN;C:\TOOLS\CP7;
  6164.      |  d:\;e:\;f:\;f:\DB;f:\;f:\COMMO;f:\SBBS;f:\SBBS\SUTL SET PCTOO-
  6165.      |  LS=C:\TOOLS\CP7
  6166.      |  set ra=f:\sbbs
  6167.      |  set dbridge=f:\db
  6168.      |  set db=f:\db
  6169.      |  set dbq=f:\db\dbutl\dbqueue.cfg
  6170.      |  set db-swapfn=c:\zdir\dbswap.$$$
  6171.      |  set tz=est6edt
  6172.      |  set golded=f:\db\gold
  6173.      |  set tic=f:\db\dbutl\tic.cfg
  6174.      |  set mbu=f:\db\dbutl\mbutil.ctl
  6175.      |  set diskstats=y
  6176.      |  set sbbs=f:\sbbs
  6177.      |  set superbbs=f:\sbbs
  6178.      |  set sutil=f:\sbbs
  6179.      |  set pcplus=f:\commo\pcp
  6180.      |  set dsz=f:\commo
  6181.      |  set dszport=4
  6182.      |  set dszopt=mr8g
  6183.      |  set dszlog=f:\logs\dsz.log
  6184.      |  set dirrx=f:\db\files\
  6185.      |  set comspec=c:\dos\command.com
  6186.      |  set x=go
  6187.      |  loadhigh c:\stacker\stacker.com
  6188.      |  pc-cache.com /sizexp=512 /If /Ig
  6189.      |  rem MIRROR C: D: E:
  6190.      |  rem BNU /T:2048 /R:2048 /L:3=38400 /F+
  6191.      |  RUNDB
  6192.      |
  6193.      |   ** CONFIG.SYS **
  6194.      |
  6195.      |  buffers=30
  6196.      |  stacks=0,0
  6197.      |  files=50
  6198.      |  device=c:\dmdrvr.bin
  6199.      |  device=c:\dos\himem.sys
  6200.      |  dos=high
  6201.      |  device=c:\ems40.sys
  6202.      |  device=c:\dos\ansi.sys
  6203.      |  devicehigh=c:\gmouse.sys
  6204.  
  6205.         --------------------------------------------------------------
  6206.         SuperBBS v1.17 Documentation                          Page 212
  6207.  
  6208.  
  6209.      |  rem devicehigh=c:\dos\ramdrive.sys 512 /e
  6210.      |  rem ------------------------------------[Fossil]-----
  6211.      |  devicehigh=c:\x00.sys B,3,38400
  6212.      |  rem devicehigh=C:\BNU.SYS /T:2048 /R:2048 /L:3=38400 /F+
  6213.      |  rem --------------------------------------[END]------
  6214.      |  break=on
  6215.      |  DEVICEhigh=c:\stacker\STACKER.COM /EMS F:\STACVOL.DSK
  6216.      |  DEVICEhigh=C:\STACKER\SSWAP.COM F:\STACVOL.DSK
  6217.      |
  6218.      |   ** RUNBBS.BAT **
  6219.      |
  6220.      |  @ECHO OFF
  6221.      |  :START
  6222.      |
  6223.      |  F:
  6224.      |  CD\DB
  6225.      |
  6226.      |  rem ----------------FOSSIL----
  6227.      |  XU CAPTURE:OFF
  6228.      |  rem BNU /Q
  6229.      |  rem ----------------FOSSIL----
  6230.      |
  6231.      |  DB
  6232.      |
  6233.      |  IF ERRORLEVEL 250 GOTO INIT
  6234.      |  IF ERRORLEVEL 160 GOTO START
  6235.      |  IF ERRORLEVEL 157 GOTO WKLYMNT
  6236.      |  IF ERRORLEVEL 156 GOTO BKUPMSG
  6237.      |  IF ERRORLEVEL 155 GOTO BKUP-C-D-E
  6238.      |  IF ERRORLEVEL 154 GOTO BKUP-F
  6239.      |  IF ERRORLEVEL 153 GOTO CRIT
  6240.      |  IF ERRORLEVEL 152 GOTO IMPORT
  6241.      |  IF ERRORLEVEL 151 GOTO UNPACK
  6242.      |  IF ERRORLEVEL 150 GOTO CLEAN
  6243.      |  IF ERRORLEVEL 145 GOTO FAX
  6244.      |  IF ERRORLEVEL 144 GOTO 14400
  6245.      |  IF ERRORLEVEL 96 GOTO 9600
  6246.      |  IF ERRORLEVEL 48 GOTO 4800
  6247.      |  IF ERRORLEVEL 24 GOTO 2400
  6248.      |  IF ERRORLEVEL 12 GOTO 1200
  6249.      |  IF ERRORLEVEL 3 GOTO 300
  6250.      |  IF ERRORLEVEL 1 GOTO LOCAL
  6251.      |  IF ERRORLEVEL 0 CLS
  6252.      |  WAIT 1
  6253.      |  rem ECHO ATH0 >COM4
  6254.      |  go
  6255.      |
  6256.  
  6257.  
  6258.  
  6259.  
  6260.  
  6261.  
  6262.  
  6263.         --------------------------------------------------------------
  6264.         SuperBBS v1.17 Documentation                          Page 213
  6265.  
  6266.  
  6267.      |  :INIT
  6268.      |  ECHO ON
  6269.      |  ECHO ATH0M1L3 >COM4
  6270.      |  WAIT 5
  6271.      |  ECHO ATZ
  6272.      |  WAIT 5
  6273.      |  ECHO OFF
  6274.      |
  6275.      |  GOTO START
  6276.      |
  6277.      |  :14400
  6278.      |  rem BNU /C
  6279.      |  XU CAPTURE:ON
  6280.      |  F:
  6281.      |  CD\SBBS
  6282.      |  BBS -b14400 -e0
  6283.      |  IF ERRORLEVEL 100 GOTO START
  6284.      |  rem IF ERRORLEVEL 25 GOTO
  6285.      |  IF ERRORLEVEL 24 GOTO BID
  6286.      |  IF ERRORLEVEL 20 GOTO RETURN
  6287.      |  IF ERRORLEVEL 10 GOTO CBV
  6288.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6289.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6290.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6291.      |  GOTO START
  6292.      |
  6293.      |  :9600
  6294.      |  rem BNU /C
  6295.      |  XU CAPTURE:ON
  6296.      |  F:
  6297.      |  CD\SBBS
  6298.      |  BBS -b9600 -e0
  6299.      |  IF ERRORLEVEL 100 GOTO START
  6300.      |  rem IF ERRORLEVEL 25 GOTO
  6301.      |  IF ERRORLEVEL 24 GOTO BID
  6302.      |  IF ERRORLEVEL 20 GOTO RETURN
  6303.      |  IF ERRORLEVEL 10 GOTO CBV
  6304.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6305.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6306.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6307.      |  GOTO START
  6308.      |
  6309.      |  :4800
  6310.      |  rem BNU /C
  6311.      |  XU CAPTURE:ON
  6312.      |  F:
  6313.      |  CD\SBBS
  6314.      |  BBS -b4800 -e0
  6315.      |  IF ERRORLEVEL 100 GOTO START
  6316.      |  rem IF ERRORLEVEL 25 GOTO
  6317.      |  IF ERRORLEVEL 24 GOTO BID
  6318.      |  IF ERRORLEVEL 20 GOTO RETURN
  6319.  
  6320.  
  6321.         --------------------------------------------------------------
  6322.         SuperBBS v1.17 Documentation                          Page 214
  6323.  
  6324.  
  6325.      |  IF ERRORLEVEL 10 GOTO CBV
  6326.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6327.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6328.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6329.      |  GOTO START
  6330.      |
  6331.      |  :2400
  6332.      |  rem BNU /C
  6333.      |  XU CAPTURE:ON
  6334.      |  F:
  6335.      |  CD\SBBS
  6336.      |  BBS -b2400 -e0
  6337.      |  IF ERRORLEVEL 100 GOTO START
  6338.      |  rem IF ERRORLEVEL 25 GOTO
  6339.      |  IF ERRORLEVEL 24 GOTO BID
  6340.      |  IF ERRORLEVEL 20 GOTO RETURN
  6341.      |  IF ERRORLEVEL 10 GOTO CBV
  6342.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6343.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6344.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6345.      |  GOTO START
  6346.      |
  6347.      |  :1200
  6348.      |  rem BNU /C
  6349.      |  XU CAPTURE:ON
  6350.      |  F:
  6351.      |  CD\SBBS
  6352.      |  BBS -b1200 -e0
  6353.      |  IF ERRORLEVEL 100 GOTO START
  6354.      |  IF ERRORLEVEL 24 GOTO BID
  6355.      |  IF ERRORLEVEL 10 GOTO CBV
  6356.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6357.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6358.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6359.      |  GOTO START
  6360.      |
  6361.      |  :300
  6362.      |  rem BNU /C
  6363.      |  XU CAPTURE:ON
  6364.      |  F:
  6365.      |  CD\SBBS
  6366.      |  BBS -b300 -e0
  6367.      |  IF ERRORLEVEL 100 GOTO START
  6368.      |  IF ERRORLEVEL 10 GOTO CBV
  6369.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6370.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6371.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6372.      |  GOTO START
  6373.      |
  6374.  
  6375.  
  6376.  
  6377.  
  6378.  
  6379.         --------------------------------------------------------------
  6380.         SuperBBS v1.17 Documentation                          Page 215
  6381.  
  6382.  
  6383.      |  :LOCAL
  6384.      |  F:
  6385.      |  CD\SBBS
  6386.      |  BBS -l -e0
  6387.      |  IF ERRORLEVEL 100 GOTO START
  6388.      |  IF ERRORLEVEL 24 GOTO BID
  6389.      |  IF ERRORLEVEL 10 GOTO CBV
  6390.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6391.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6392.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6393.      |  IF ERRORLEVEL 2 GOTO START
  6394.      |  GOTO START
  6395.      |
  6396.      |  :RETURN
  6397.      |  F:
  6398.      |  CD\SBBS
  6399.      |  BBS -r -e0
  6400.      |  IF ERRORLEVEL 100 GOTO START
  6401.      |  IF ERRORLEVEL 24 GOTO BID
  6402.      |  IF ERRORLEVEL 10 GOTO CBV
  6403.      |  IF ERRORLEVEL 5 GOTO NET/ECHO
  6404.      |  IF ERRORLEVEL 4 GOTO ECHOMAIL
  6405.      |  IF ERRORLEVEL 3 GOTO NETMAIL
  6406.      |  GOTO START
  6407.      |
  6408.      |  :CBV
  6409.      |  F:
  6410.      |  CD\SBBS\CBV
  6411.      |  RADDS
  6412.      |  GOTO RETURN
  6413.      |
  6414.      |  :FAX
  6415.      |  F:
  6416.      |  CD\COMMO\FAX
  6417.      |  NETFAXREC COM4
  6418.      |  IF ERRORLEVEL 1 GOTO RECFAX
  6419.      |  GOTO RETURN
  6420.      |
  6421.      |  :RECFAX
  6422.      |  CD\SBBS
  6423.      |  SUTIL POST 2 RECFAX.TXT SYSOP NETFAX FAX
  6424.      |  GOTO RETURN
  6425.      |
  6426.      |  :BID
  6427.      |  F:
  6428.      |  CD\SBBS\BID
  6429.      |  BID
  6430.      |  GOTO RETURN
  6431.      |
  6432.      |  :NET/ECHO
  6433.      |  GOTO NETMAIL
  6434.      |
  6435.  
  6436.  
  6437.         --------------------------------------------------------------
  6438.         SuperBBS v1.17 Documentation                          Page 216
  6439.  
  6440.  
  6441.      |  :ECHOMAIL
  6442.      |  GOTO RETURN
  6443.      |
  6444.      |  :NETMAIL
  6445.      |  F:
  6446.      |  CD\DB\DBUTL
  6447.      |  dir >nul
  6448.      |  MBUTIL EXPORT
  6449.      |  GOTO START
  6450.      |
  6451.      |  :MAIL
  6452.      |  F:
  6453.      |  CD\DB\DBUTL
  6454.      |  MBUTIL EXPORT -RETEAR
  6455.      |  GOTO START
  6456.      |
  6457.      |  :UNPACK
  6458.      |  F:
  6459.      |  CD\DB\DBUTL
  6460.      |  MBUTIL IMPORT
  6461.      |  MBUTIL SORT -PACK
  6462.      |  MBUTIL LINK -CLEAN
  6463.      |  GOTO START
  6464.      |
  6465.      |  :CLEAN
  6466.      |  F:
  6467.      |  CD\DB\DBUTL
  6468.      |  MBUTIL PURGE -FILE PURGE.MBU
  6469.      |  MBUTIL PACK -FORCE -DELETE -RECOVER
  6470.      |  GOTO START
  6471.      |
  6472.      |  :IMPORT
  6473.      |  F:
  6474.      |  CD\DB\DBUTL
  6475.      |  MBUTIL IMPORT F:\DB\MESSAGES\DBSOFT DB_SOFT -DELETE
  6476.      |  MBUTIL IMPORT F:\DB\MESSAGES\DBTECH DB_TECH -DELETE
  6477.      |  GOTO START
  6478.      |
  6479.      |  :UNFRAG
  6480.      |  CALL F:\DB\FRESH
  6481.      |  GOTO START
  6482.      |
  6483.      |  :BKUP-C-D-E
  6484.      |  C:
  6485.      |  CD\TOOLS\CP7
  6486.      |  CPBACKUP FULL-C-D-E
  6487.      |  GOTO START
  6488.      |
  6489.      |  :BKUP-F
  6490.      |  C:
  6491.      |  CD\TOOLS\CP7
  6492.      |  CPBACKUP FULL-F
  6493.      |  GOTO START
  6494.  
  6495.         --------------------------------------------------------------
  6496.         SuperBBS v1.17 Documentation                          Page 217
  6497.  
  6498.  
  6499.      |  :BKUPMSG
  6500.      |  C:
  6501.      |  CD\TOOLS\CP7
  6502.      |  CPBACKUP MSGBASE
  6503.      |  GOTO START
  6504.      |
  6505.      |  :WKLYMNT
  6506.      |  F:
  6507.      |  CD\SBBS
  6508.      |  SUTIL AUTO BBSWKLY.CTL
  6509.      |  GOTO START
  6510.      |
  6511.      |  :CRIT
  6512.      |  F:
  6513.      |  CD\CRIT
  6514.      |  IF EXIST USERS.BK1 DEL USERS.BK1
  6515.      |  IF EXIST SUSERS.BK1 DEL SUSERS.BK1
  6516.      |  IF EXIST USERS.BBS REN USERS.BBS USERS.BK1
  6517.      |  IF EXIST SUSERS.BBS REN SUSERS.BBS SUSERS.BK1
  6518.      |  COPY F:\SBBS\USERS.BBS
  6519.      |  COPY F:\SBBS\SUSERS.BBS
  6520.      |
  6521.      |  rem COPY F:\SBBS\*.BBS A:\
  6522.      |  rem COPY F:\DB\DBRIDGE.AUT A:\
  6523.      |  rem COPY F:\DB\DBRIDGE.CFG A:\
  6524.      |
  6525.      |  cd\db\dbutl
  6526.      |  mbutil pack -force -delete -recover
  6527.      |
  6528.      |  CD\SBBS
  6529.      |  STOP TOP10 U15 D15 C15 M15 I
  6530.      |  USERPACK
  6531.      |  USERSORT SEC- LAST+ FIRST+
  6532.      |  SUTIL AUTO F:\SBBS\BBSMAINT.CTL >f:\logs\sutil.log
  6533.      |
  6534.      |  CD\SBBS\SBLU
  6535.      |  COPY F:\SBBS\STXT\NEWS.ANS
  6536.      |  COPY D:\FILES\DOWN\ETCFILES.NEW NEWFILES.DAT
  6537.      |
  6538.      |  F:
  6539.      |  CD\LOGS
  6540.      |  DBTRIM 14 DBRIDGE.LOG
  6541.      |
  6542.      |  D:
  6543.      |  CD\FILES\DOWN
  6544.      |  PKZIP ETCFILES.ZIP ETCFILES.TXT
  6545.      |
  6546.      |  F:
  6547.      |  IF EXIST F:\DB\FILES\*.* GOTO NEWFILES
  6548.      |  GOTO START
  6549.  
  6550.  
  6551.  
  6552.  
  6553.         --------------------------------------------------------------
  6554.         SuperBBS v1.17 Documentation                          Page 218
  6555.  
  6556.  
  6557.      |  :NEWFILES
  6558.      |  F:
  6559.      |  CD\DB\FILES
  6560.      |  IF NOT EXIST N387LIST.* GOTO NDIFF
  6561.      |  COPY N387LIST.* F:\DB\NODELIST
  6562.      |  DEL N387LIST.*
  6563.      |
  6564.      |  :NDIFF
  6565.      |  F:
  6566.      |  CD\DB\FILES
  6567.      |  IF NOT EXIST NODEDIFF.* GOTO NPN
  6568.      |  COPY NODEDIFF.* F:\DB\NODELIST
  6569.      |  DEL NODEDIFF.*
  6570.      |
  6571.      |  :NPN
  6572.      |  F:
  6573.      |  CD\DB\FILES
  6574.      |  IF NOT EXIST NPNBULL.ZIP GOTO NPNLIST
  6575.      |  COPY NPNBULL.ZIP F:\SBBS\WORK
  6576.      |  CD\SBBS\WORK
  6577.      |  PKUNZIP NPNBULL.ZIP
  6578.      |  TYPE UPDATE.TXT >>D:\FILES\FNPN\UPDATE.TXT
  6579.      |  DEL UPDATE.TXT
  6580.      |  COPY *.ZIP D:\FILES\FNPN
  6581.      |  DEL *.ZIP
  6582.      |  CD\DB\FILES
  6583.      |
  6584.      |  :NPNLIST
  6585.      |  F:
  6586.      |  CD\DB\FILES
  6587.      |  IF NOT EXIST NPNLIST.* GOTO ALAMO
  6588.      |  COPY NPNLIST.* F:\DB\NODELIST
  6589.      |  DEL NPNLIST.*
  6590.      |
  6591.      |  :ALAMO
  6592.      |  F:
  6593.      |  CD\DB\FILES
  6594.      |  IF NOT EXIST 1836LIST.* GOTO NAC-NET
  6595.      |  COPY 1836LIST.* F:\DB\NODELIST
  6596.      |  DEL 1836LIST.*
  6597.      |
  6598.      |  :NAC-NET
  6599.      |  F:
  6600.      |  CD\DB\FILES
  6601.      |  IF NOT EXIST NAC-NET.* GOTO AFILES
  6602.      |  COPY NAC-NET.* F:\DB\NODELIST
  6603.      |  DEL NAC-NET.*
  6604.      |
  6605.  
  6606.  
  6607.  
  6608.  
  6609.  
  6610.  
  6611.         --------------------------------------------------------------
  6612.         SuperBBS v1.17 Documentation                          Page 219
  6613.  
  6614.  
  6615.      |  :AFILES
  6616.      |  F:
  6617.      |  CD\DB\FILES
  6618.      |  IF NOT EXIST ALAMO*.* GOTO TICK
  6619.      |  COPY ALAMO*.* D:\FILES\ALAMO
  6620.      |  DEL ALAMO*.*
  6621.      |
  6622.      |  :TICK
  6623.      |  F:
  6624.      |  CD\DB\FILES
  6625.      |  IF NOT EXIST *.TIC GOTO FLEA
  6626.      |  CD\DB\DBUTL
  6627.      |  TICK >>F:\LOGS\TIC.LOG
  6628.      |
  6629.      |  :FLEA
  6630.      |  F:
  6631.      |  CD\DB\FILES
  6632.      |  IF NOT EXIST *.FLE GOTO BBSLIST
  6633.      |  CD\DB\UTIL
  6634.      |  TICK >>F:\LOGS\TIC.LOG
  6635.      |
  6636.      |  :BBSLIST
  6637.      |  F:
  6638.      |  CD\DB\FILES
  6639.      |  IF NOT EXIST BBSLST.ZIP GOTO QWK
  6640.      |  COPY BBSLST.ZIP D:\FILES\DOWN
  6641.      |  PKUNZIP BBSLST.ZIP
  6642.      |  COPY BBSLST.SCR F:\SBBS\STXT\BULLET2.ANS
  6643.      |  COPY BBSLST.BBS F:\SBBS\STXT\BULLET2.ASC
  6644.      |  DEL BBSLST.*
  6645.      |
  6646.      |  :QWK
  6647.      |  F:
  6648.      |  CD\DB\FILES
  6649.      |  IF NOT EXIST *.QWK GOTO ECHOSTAT
  6650.      |  COPY *.QWK F:\BLUE\DOWN
  6651.      |  DEL *.QWK
  6652.      |
  6653.      |  :ECHOSTAT
  6654.      |  F:
  6655.      |  CD\DB\FILES
  6656.      |  IF NOT EXIST SS_AREAS.ARC GOTO SCAN
  6657.      |  COPY SS_AREAS.* E:\FILES\SYSO
  6658.      |  DEL SS_AREAS.*
  6659.      |
  6660.      |  :SCAN
  6661.      |  SCAN F:\DB\FILES /A /D /NOPAUSE /REPORT F:\LOGS\VIRUS.TMP IF
  6662.      |  ERRORLEVEL 2 GOTO START
  6663.      |  IF ERRORLEVEL 1 TYPE F:\LOGS\VIRUS.TMP >>F:\LOGS\DBRIDGE.LOG
  6664.      |  DIR /A-D /ON F:\DB\FILES >>F:\LOGS\VIRUS.LOG
  6665.      |  TYPE F:\LOGS\VIRUS.TMP >>F:\LOGS\VIRUS.LOG
  6666.      |  CD\DB\FILES
  6667.  
  6668.  
  6669.         --------------------------------------------------------------
  6670.         SuperBBS v1.17 Documentation                          Page 220
  6671.  
  6672.  
  6673.      |  COPY *.* F:\FILES
  6674.      |  ECHO Y | DEL *.*
  6675.      |  GOTO START
  6676.      |
  6677.      |  :RESET
  6678.      |  E:
  6679.      |  CD\SBBS
  6680.      |  IF EXIST ERRORS.LOG TYPE ERRORS.LOG >PRN
  6681.      |  IF EXIST ERRORS.BBS TYPE ERRORS.BBS >PRN
  6682.      |  IF EXIST ERRORS.BBS GOTO END
  6683.      |  WAIT 1
  6684.      |  ECHO ATZ >COM4
  6685.      |  WAIT 1
  6686.      |  CLS
  6687.      |  BOOT
  6688.      |
  6689.      |  :END
  6690.      |  CLS
  6691.      |  ECHO ---------------------------------------------------------
  6692.      |  ECHO ---------------------------------------------------------
  6693.      |  ECHO ** FATAL ERROR: THE MEDNET IS DOWN...  NOTIFY BOB ASAP **
  6694.      |  ECHO ---------------------------------------------------------
  6695.      |  ECHO ---------------------------------------------------------
  6696.      |
  6697.      |  Information by Bob Jackson,
  6698.      |                 ETC MedNet,
  6699.      |                 1:387/801 Fidonet,
  6700.      |                 San Antonio, Texas
  6701.      |
  6702.      |  Hope that these examples have been of any use. Let me know if
  6703.      |  you want more information on how to run a SuperBBS system.
  6704.      |
  6705.      |  Multiline setup examples are not available. If you have a
  6706.      |  multiline setup, let me have the example to setup a system and
  6707.      |  your info will be used in the 1.18 documentation.
  6708.  
  6709.         14.2      Equipment
  6710.         --------------------------------------------------------------
  6711.  
  6712.         SuperBBS has been tested with a wide variety of machines,
  6713.         ranging from a simple XT to a 80486-33 Mhz, and software,
  6714.         including MS-Dos 5.0, JP Software 4DOS 4.00 and Desqview. If
  6715.         you have any trouble running a certain combination of hardware
  6716.         and/or software, contact the support nodes. They might be able
  6717.         to help, or give you information on how to obtain help.
  6718.  
  6719.  
  6720.  
  6721.  
  6722.  
  6723.  
  6724.  
  6725.  
  6726.  
  6727.         --------------------------------------------------------------
  6728.         SuperBBS v1.17 Documentation                          Page 221
  6729.  
  6730.  
  6731.         14.3      Turbo Pascal/Run time errors
  6732.         --------------------------------------------------------------
  6733.  
  6734.         SuperBBS is written in Turbo Pascal. Here are some Turbo
  6735.         Pascal errors. If you receive a message like:
  6736.  
  6737.              Runtime error: ????
  6738.  
  6739.         It means an error occurred. The following list might help you
  6740.         to discover what went wrong.
  6741.  
  6742.         Code.........: 2
  6743.         Description..: File not found
  6744.         Solution.....: You've deleted a SuperBBS file and SuperBBS
  6745.                        can't find it. Check which file is possibly
  6746.                        missing and replace it.
  6747.  
  6748.         Code.........: 3
  6749.         Description..: Path not found
  6750.         Solution.....: You've configured a non existing path in the
  6751.                        configuration. Check your setup.
  6752.  
  6753.         Code.........: 4
  6754.         Description..: Too many open files
  6755.         Solution.....: MsDos 'Files=??' statement in config.sys is too
  6756.                        low, increase the value. You will need to re-
  6757.                        boot your computer.
  6758.  
  6759.         Code.........: 5
  6760.         Description..: File access denied
  6761.         Solution.....: You've used a Hidden/ReadOnly attribute with a
  6762.                        SuperBBS file. Don't do that!
  6763.  
  6764.         Code.........: 15
  6765.         Description..: Invalid drive number
  6766.         Solution.....: You've configured an illegal drive in the con-
  6767.                        figuration.
  6768.  
  6769.         Code.........: 100
  6770.         Description..: Disk read error
  6771.         Solution.....: Your hard disk has problems, check it.
  6772.  
  6773.         Code.........: 103
  6774.         Description..: File not open
  6775.         Solution.....: Problems with open/close/read files, try to
  6776.                        increase 'Files=??' statement first.
  6777.  
  6778.         Code.........: 150
  6779.         Description..: Disk write protected
  6780.         Solution.....: You've a write protected disk, don't do that.
  6781.  
  6782.  
  6783.  
  6784.         --------------------------------------------------------------
  6785.         SuperBBS v1.17 Documentation                          Page 222
  6786.  
  6787.  
  6788.         Code.........: 151
  6789.         Description..: Unknown unit
  6790.         Solution.....: You've configured an illegal unit/drive in the
  6791.                        configuration.
  6792.  
  6793.         Code.........: 152
  6794.         Description..: Drive not ready
  6795.         Solution.....: Problems with your disk drive, check it.
  6796.  
  6797.         Code.........: 156
  6798.         Description..: Disk seek error
  6799.         Solution.....: Problems with your disk drive, check it.
  6800.  
  6801.         Code.........: 157
  6802.         Description..: Unknown media type
  6803.         Solution.....: Operating system doesn't recognize your disk
  6804.                        drive's format. Check it.
  6805.  
  6806.         Code.........: 158
  6807.         Description..: Sector not found
  6808.         Solution.....: Problems with your disk drive, check it.
  6809.  
  6810.         Code.........: 162
  6811.         Description..: Hardware failure
  6812.         Solution.....: Problems with your hardware, check it.
  6813.  
  6814.         Code.........: 200
  6815.         Description..: Division by zero
  6816.         Solution.....: Program error, inform authors.
  6817.  
  6818.         Code.........: 202
  6819.         Description..: Stack overflow error
  6820.         Solution.....: Program error, inform authors.
  6821.  
  6822.      |  Errors not mentioned here can also be experienced, but they
  6823.      |  are not normal. You will also get an error above 202 when your
  6824.      |  .SCC file is not found or valid.
  6825.  
  6826.         That's it. For more information about these errors, refer to
  6827.         the Turbo Pascal manuals, or contact the nearest SuperBBS help
  6828.         support.
  6829.  
  6830.         14.4      Credits
  6831.         --------------------------------------------------------------
  6832.  
  6833.         All names and programs mentioned in this documentation are
  6834.         copyrighted by their owners. Please observe the rules to use
  6835.         these programs and register them if needed. Shareware can't
  6836.         live without your support. Do not use illegally obtained soft-
  6837.         ware. Nobody mentioned, nobody forgotten.
  6838.  
  6839.         We thank every writer of software available to SuperBBS for
  6840.         his/her contribution. Keep up the good work!
  6841.  
  6842.  
  6843.         --------------------------------------------------------------
  6844.         SuperBBS v1.17 Documentation                          Page 223
  6845.  
  6846.  
  6847.         Chapter 15     SuperNet
  6848.         ==============================================================
  6849.  
  6850.         SuperNet is an elite network joining SuperBBS bulletin board
  6851.         systems all over the world. It is a direct connection to the
  6852.         SuperBBS group, documentation writer and users alike to dis-
  6853.         cuss SuperBBS operations and development, watch for program
  6854.         and utilities updates or just a place to chat about SuperBBS.
  6855.         SuperNet will make a nice addition to your local SuperBBS
  6856.         bulletin board system.
  6857.  
  6858.         Currently SuperNet is available in the following countries:
  6859.  
  6860.              - Finland
  6861.              - Sweden
  6862.              - Denmark
  6863.              - Norway
  6864.              - USA
  6865.              - Canada
  6866.              - Germany
  6867.              - The Netherlands
  6868.              - Japan
  6869.              - Taiwan
  6870.              - Switzerland
  6871.              - China
  6872.              - Australia
  6873.              - and more.....
  6874.  
  6875.         For more information concerning SuperNet, contact the Support
  6876.         boards of SuperBBS. Most systems are connected to SuperNet.
  6877.  
  6878.         SuperNet nodes are using the 42:xxxx/xxxx node numbers. The
  6879.         Northern America sites are using net 43 for their nodenumbers.
  6880.         Net 44 is used for the BBS nodes in Japan and Taiwan. Net 45
  6881.         is used in Australia.
  6882.  
  6883.         Most SuperNet systems have the nodelist available for down-
  6884.         load. Ask a SuperBBS Support site for one, if you can't find
  6885.         a nodelist from SuperNet near you.
  6886.  
  6887.         There are several echomail areas available in SuperNet. Most
  6888.         of these areas are available to all users and Sysops of the
  6889.         Bulletin Board System.
  6890.  
  6891.         Here's a short overview:
  6892.  
  6893.         Area.........: SBBS_INT
  6894.         Description..: SuperNet echomail about all kinds of subjects,
  6895.                        not necessarily about SuperBBS.
  6896.         Available to.: Sysops and users
  6897.  
  6898.  
  6899.  
  6900.  
  6901.         --------------------------------------------------------------
  6902.         SuperBBS v1.17 Documentation                          Page 224
  6903.  
  6904.  
  6905.         Area.........: Superthoughts
  6906.         Description..: SuperNet echomail for chit chat. Subject is
  6907.                        free. (Except for personal attacks and commer-
  6908.                        cials).
  6909.         Available to.: Sysops and users
  6910.  
  6911.         Area.........: SBBS_BUGS
  6912.         Description..: SuperNet echomail for reporting bugs in Super-
  6913.                        BBS. Replies can be given as long they concern
  6914.                        the subject.
  6915.         Available to.: Sysops (write access)
  6916.  
  6917.         Area.........: SBBS_TIPS
  6918.         Description..: SuperNet echomail for tips and hints about
  6919.                        SuperBBS. Replies can be given as long they
  6920.                        concern the subject.
  6921.         Available to.: Sysops (write access)
  6922.  
  6923.         Area.........: SNET_INT
  6924.         Description..: SuperNet READ ONLY echomail area with news from
  6925.                        the SuperNet coordinators and the SuperBBS
  6926.                        team.
  6927.         Available to.: Sysops (READ ONLY)
  6928.  
  6929.         More areas are available, this is only a small sample of the
  6930.         current areas. Most countries have their own national echomail
  6931.         areas available.
  6932.  
  6933.         Join an elite network, join SuperNet!
  6934.  
  6935.  
  6936.  
  6937.  
  6938.  
  6939.  
  6940.  
  6941.  
  6942.  
  6943.  
  6944.  
  6945.  
  6946.  
  6947.  
  6948.  
  6949.  
  6950.  
  6951.  
  6952.  
  6953.  
  6954.  
  6955.  
  6956.  
  6957.  
  6958.  
  6959.         --------------------------------------------------------------
  6960.         SuperBBS v1.17 Documentation                          Page 225
  6961.  
  6962.  
  6963.         Appendix A     Menu list
  6964.         ==============================================================
  6965.  
  6966.         Menu    Description                                     Page
  6967.         ------  ----------------------------------------------  ------
  6968.          0      Text line                                       108
  6969.          1      Goto new menu                                   109
  6970.          2      Gosub new menu                                  109
  6971.          3      Return from last gosub                          109
  6972.          4      Goto new menu and clear gosub stack             110
  6973.          5      Display .ANS/.ASC file                          110
  6974.          6      Selection menu                                  110
  6975.          7      Shell to dos                                    111
  6976.          8      Version and copyright notice                    112
  6977.          9      Logoff from system                              112
  6978.         10      Display system usage graph                      113
  6979.         11      Page the Sysop                                  113
  6980.         12      Execute questionnaire                           113
  6981.         13      List/search userlist                            113
  6982.         14      Time statistics                                 113
  6983.         15      Exit to DOS with errorlevel                     114
  6984.         16      Change city and state                           114
  6985.         17      Change password                                 114
  6986.         18      Change screenlength                             114
  6987.         19      Toggle screen clearing                          114
  6988.         20      Toggle more prompt                              114
  6989.         21      Toggle ANSI graphics                            114
  6990.         22      Scan for personal mail                          115
  6991.         23      Read messages                                   115
  6992.         24      Scan messages                                   115
  6993.         25      Quick scan messages                             115
  6994.         26      Delete messages                                 116
  6995.         27      Write messages                                  116
  6996.         28      Select combined message areas                   116
  6997.         29      Move a file                                     117
  6998.         30      MS-Dos directory list                           117
  6999.         31      List FILES.BBS                                  117
  7000.         32      Download file                                   117
  7001.         33      Upload file                                     118
  7002.         34      View archived file                              118
  7003.         35      Search for file by keyword                      118
  7004.         36      Search for file by filename                     118
  7005.         37      List new files on system                        118
  7006.         38      Type a textfile                                 119
  7007.         39      Display a textfile                              119
  7008.         40      Display .ANS/.ASC file with Hotkey enabled      119
  7009.         41      Toggle fullscreen editor                        119
  7010.         45      Display .ANS/.ASC file with 'Press ENTER'       120
  7011.         46      Show GIF resolution                             120
  7012.         47      Write entry in system logfile                   120
  7013.         48      Download specific file                          120
  7014.         53      Toggle mailcheck at logon                       121
  7015.         54      Toggle newfiles check at logon                  121
  7016.  
  7017.         --------------------------------------------------------------
  7018.         SuperBBS v1.17 Documentation                          Page 226
  7019.  
  7020.  
  7021.         55      Show BBS list (Short)                           121
  7022.         56      Add BBS to BBS list                             121
  7023.         57      Leave comment for next user                     121
  7024.         58      Show callers                                    121
  7025.         59      Change colour configuration                     122
  7026.         60      Extract files                                   122
  7027.         61      Archive files                                   122
  7028.         62      Delete files                                    122
  7029.         63      Show BBS list (Long)                            123
  7030.         64      Change BBS information in BBS list              123
  7031.         65      Delete BBS information in BBS list              123
  7032.         66      Download BBS list                               123
  7033.         67      Change user's phonenumber(s)                    123
  7034.         68      Select message area from list                   123
  7035.         69      Select/Pick file area from list                 124
  7036.         70      Change alias                                    124
  7037.         71      List aliases                                    125
  7038.         72      Show user's balance in timebank                 125
  7039.         73      Deposit time in timebank                        125
  7040.         74      Withdraw time from timebank                     125
  7041.         75      User online                                     125
  7042.         76      Send message to other line                      125
  7043.         77      Change current language                         125
  7044.         78      Toggle 'Do not disturb' flag                    126
  7045.         79      Toggle fullscreen message viewer                126
  7046.         80      Display areas with unread mail                  126
  7047.         81      Perform viruscheck                              126
  7048.         82      Download QWK packet                             126
  7049.         83      Upload QWK reply packet                         126
  7050.         84      Toggle lastread pointer                         127
  7051.         85      Show random aphorism                            127
  7052.         86      Run a door                                      127
  7053.         87      Choose a door                                   128
  7054.         88      Browse the nodelist                             128
  7055.         89      Area by area read command                       128
  7056.         90      Send local file attach                          128
  7057.         91      Local file attach check                         129
  7058.         92      Change packer for QWK                           129
  7059.         93      Download ANY file                               129
  7060.         94      Display user age graph                          129
  7061.         95      Remove or show flagged files                    129
  7062.         96      Use combined boards for mail check              130
  7063.         97      Select default protocol                         130
  7064.         98      Toggle hotkeys                                  130
  7065.         99      Node chat                                       130
  7066.         100     Create/remove node chat conference              130
  7067.         101     Leave/remove message comment                    130
  7068.  
  7069.  
  7070.  
  7071.  
  7072.  
  7073.  
  7074.  
  7075.         --------------------------------------------------------------
  7076.         SuperBBS v1.17 Documentation                          Page 227
  7077.  
  7078.  
  7079.         Appendix B     Bugreport and Suggestion form
  7080.         ==============================================================
  7081.  
  7082.         Suggestions form. Send this to the SuperBBS HQ in Finland.
  7083.  
  7084.         Date..................:   ... - ... - 19 ...
  7085.  
  7086.         Name..................:   ____________________________________
  7087.  
  7088.         Address...............:   ____________________________________
  7089.  
  7090.                                   ____________________________________
  7091.  
  7092.                                   ____________________________________
  7093.  
  7094.         BBS name..............:   ____________________________________
  7095.  
  7096.         BBS telephone nr......:   ____________________________________
  7097.  
  7098.         My suggestion is :
  7099.  
  7100.         ______________________________________________________________
  7101.  
  7102.         ______________________________________________________________
  7103.  
  7104.         ______________________________________________________________
  7105.  
  7106.         ______________________________________________________________
  7107.  
  7108.         ______________________________________________________________
  7109.  
  7110.         ______________________________________________________________
  7111.  
  7112.         ______________________________________________________________
  7113.  
  7114.         ______________________________________________________________
  7115.  
  7116.         ______________________________________________________________
  7117.  
  7118.         ______________________________________________________________
  7119.  
  7120.         ______________________________________________________________
  7121.  
  7122.         ______________________________________________________________
  7123.  
  7124.         ______________________________________________________________
  7125.  
  7126.         ______________________________________________________________
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.         --------------------------------------------------------------
  7134.         SuperBBS v1.17 Documentation                          Page 228
  7135.  
  7136.  
  7137.         Bugreport form. Send this to the SuperBBS HQ in Finland.
  7138.  
  7139.         Date..................:   ... - ... - 19 ...
  7140.  
  7141.         Name..................:   ____________________________________
  7142.  
  7143.         Address...............:   ____________________________________
  7144.  
  7145.                                   ____________________________________
  7146.  
  7147.                                   ____________________________________
  7148.  
  7149.         BBS name..............:   ____________________________________
  7150.  
  7151.         BBS telephone nr......:   ____________________________________
  7152.  
  7153.         The bug found is :          (Please be as clearly as possible)
  7154.  
  7155.         ______________________________________________________________
  7156.  
  7157.         ______________________________________________________________
  7158.  
  7159.         ______________________________________________________________
  7160.  
  7161.         ______________________________________________________________
  7162.  
  7163.         ______________________________________________________________
  7164.  
  7165.         ______________________________________________________________
  7166.  
  7167.         ______________________________________________________________
  7168.  
  7169.         ______________________________________________________________
  7170.  
  7171.         ______________________________________________________________
  7172.  
  7173.         ______________________________________________________________
  7174.  
  7175.         ______________________________________________________________
  7176.  
  7177.         ______________________________________________________________
  7178.  
  7179.         ______________________________________________________________
  7180.  
  7181.         ______________________________________________________________
  7182.  
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.  
  7189.  
  7190.  
  7191.         --------------------------------------------------------------
  7192.         SuperBBS v1.17 Documentation                          Page 229
  7193.  
  7194.  
  7195.  
  7196.  
  7197.  
  7198.  
  7199.  
  7200.  
  7201.  
  7202.  
  7203.  
  7204.  
  7205.  
  7206.  
  7207.  
  7208.  
  7209.  
  7210.  
  7211.  
  7212.  
  7213.  
  7214.  
  7215.  
  7216.  
  7217.  
  7218.  
  7219.  
  7220.  
  7221.                             That's all folks!
  7222.                      See you around for version 1.18
  7223.  
  7224.                        The author: Frank Hemmelder
  7225.  
  7226.  
  7227.  
  7228.  
  7229.  
  7230.  
  7231.  
  7232.  
  7233.  
  7234.  
  7235.  
  7236.  
  7237.  
  7238.  
  7239.  
  7240.  
  7241.  
  7242.  
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.  
  7249.         --------------------------------------------------------------
  7250.         SuperBBS v1.17 Documentation                          Page 230
  7251.